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Electron 64K? 
well, not quite 


Sir Clive Sinclair caused quite a F 


controversy when he launched the 
QL with the claim that it was a 32-bit 
computer but even this gamesman- 


ship pales into insignificance when 
compared to one company that f 


recently advertised in the Irish 
magazine Micro News and Market. 


The advert is headed with the bold f= 


claim that the Electron 64K is now 
available. 64K? Well, that’s what the 
ad said! As no one in the E&CM 
office had heard that Acorn were 
producing an expanded version of 
the machine the advert naturally 
caused some considerable interest. 


A ‘phone call to Ireland dashed all F 


hopes of an E&CM scoop however 
as it turned out that the advert was 
for the 32K machine that we all 


know and love. The Irish distributer [ 


had, however, decided, in describ- 
ing the memory size of computer, to 


include not only the RAM but also [ 


the firmware. Now while people are 
at liberty to do this the fact that con- 
ventionally only the RAM is included 
in the description of a computer’s 
memory could prompt accusations 
of sharp practice. Ail the more so in 
view of the fact that those new to 
computing would be more than 


confused by such claims. A 64K § 


Electron would appear to have more 
memory than a 48K Oric. 
Let's hope that such practices do 


not find their way over to this 


country. 


Amstrad in the | 


The Amstrad CPC464 is starting to 
attract the attention of add-on 
‘manufacturers. One example is 
Computer Services who have 
announced that they are able to 
supply a lead to connect the com- 
puter to any Centronics compatible 


printer. The leads are available ex- § 
stock from the company at 63 Quilp 


Drive, Chelmsford, Essex, CM1 
4YD. The price is £14.87 fully inclu- 
sive 


Little surprise 
at Aries move 


In what is described as a surprise 
move, Aries Computers have 
dropped the price of their Aries-B20 
20K expansion board for the BBC 
micro by no less than 20%. The 
company have in the past few 
months been concerned that a 
patent which they hold in respect of 
the memory board is being infringed 
by other companies who, Aries 
claim, are producing cheap imita- 
tions. Aries contend that these pale 
imitations of their board will be the 
subject of punitive legal action. They 
also state that people will be in fora 
nasty shock when details of their 


patent .application are published. 
Certainly many people are eagerly 
awaiting disclosure of these details 
as on the surface of it there seems 
little basis on which to establish a 
patent. 

The fact that Aries can afford to 
shave 30% off the retail price of the 
board could be seen as an indica- 
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tion that the company are prepared 
to fight for a share of the memory 
add-on market on conventional 
commercial grounds rather than 
keeping the field to themselves by 
threatening tegal action claiming 
infrigement of a patent that they 
seem reluctant to disclose. 


Spot the change | 
at Dragon 


When is a Dragon not a Dragon? 
The answer: when it's Touchmaster. 

By now most of you will have ; 
heard that a company with the 
delightful name of Eurohard have 
purchased all assets of the defunct 
Dragon Data Limited and intend to 
Start production of Dragon products 
in Spain some time later in the year. 

Confirmation of this news 
reached us by way of a press 
release from the newly formed 
Touchmaster Limited. Touchmaster 
is an interesting company, it is 
based on the Kenfig Industrial 
Estate in Port Talbot, the same 
address from which Dragon Data 
traded and has on its staff Brian 
Moore and Richard Wadham, both 
of whom served time with Dragon 
Data. The company are a wholly 
owned subsidiary of Prutec, Prutec 
too had a stake in Dragon Data 
before the collapse earlier this year. 

Touchmaster was set up to 
manufacture a pressure sensitive 
graphics tablet first seen on the 
GEC/Dragon stand at this year's 
CETEX exhibition. The press release 
states though that Touchmaster will 
also be offering Eurohard technical 
assistance with the production of 
existing Dragon products and with 
future technical developments, they 
are also apparently to be responsi- 
ble for certain, unspecified aspects 
of customer support and software 
sales for Dragon products in UK ter- 
ritories. 

All very confusing and when you 
hear the final ingredient to the tale is 
GEC, another name familiar to fol- 
lowers of Dragon tales; who will be 
responsible for sales and service of 
Dragon products you can see why 
we posed the question at the start of 
this item. 


Full colour 
computer show 


Whatever the future of the Dragon 
computer may turn out to be, there 
are still a considerable number of 
32s and 64s in the hands of hob- 
byists. In view of this it is perhaps 
surprising that to date there has not 
been a show dedicated to these 
machines along the lines of the for- 
mula so successfully pioneered by 
the likes of the ZX and BBC exhibi- 
tions. _ Computer Marketplace 


1 (Exhibitions) Ltd. will plug this gap in 


the market later on this year. Their 
6809 colour show will take place 
over the weekend of November 17th 
and 18th at the Royal Horticultural 
Hall in. Westminster. 

Any potential exhibitors requiring 
details of stands available should 
contact Tim Collins at Computer 
Market Place, 20 Orange Street, 
London, WC2 7ED. 01 930 1612. 


OCTOBER 1984 


RATs take control 


Cheetah Marketing, the company 
recently acquired by Parc Elec- 
tronics for a sum in excess of 1.4 
million, have launched a new infra- 
red action joystick forthe Spectrum. 
The RAT, which stands for Remote 
Action Transmitter, is designed to 
change the face of the more tradi- 
tional conception of this peripheral. 

The unit consists of two parts. The 
receiver, which plugs directly into 
the edge connector of the Spectrum 
and the transmitter. This is control- 
led by touch and has two buttons or 
“pads”; one of these is for firing and 
the second is to control direction 
and has a number of raised domes 


which are touch sensitive. The pad 
enables a very fast response and 
the infra red signals are transmitted 
by the light emitting diodes in the 
front of the transmitter over a fairly 
wide angle so that the unit does not 
necessarily have to be directly 
pointing at the screen. 

No additional software is required 
for the unit and the company are 
hoping to make it compatible with 
other machines. The RAT will retail 
at £29.95 and is available from 
Cheetah Marketing, 24 Ray Street, 
London, ECiR 3DJ, Telephone 
number 011-833-4909. 


Compunet launch at 


PCW show 


Compunet, Commodore's answer 
to the recently introduced CBM 64 
Micronet service, has run into 
delays which have put back the 
launch of the facility until mid-Sep- 
tember. The delays have been 
caused by difficulties associated 
with the host computer’s software 
rather than any production prob- 
lems concerning the modem that 
forms part of the package. It is 
hoped that the service will be ready 
in time for official launch at the PCW 
show and that people subscribing 
to the service at the show will be 
able to take a modem away with 
them and log on to the network as 
soon as they return home. 
Compunet, incidentally, em- 
bodies a number of interesting 
features. The first of these is that the 
majority of the user terminal soft- 
ware is downloaded from the host 
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computer at log-on — the firmware 
within the modem being the 
minimum required to establish the 
communications link between the 
two systems. This has a number of 
advantages, not jeast of which is 
that modifications and improve- 
ments to the service can be made 
by simply updating the host soft- 
ware. Another interesting aspect of 
the service is that downloaded soft- 
ware will be run time dongle pro- 
tected — the dongle in this case 
being the users modem. Thus while 
Compunet software may be backed 
up to tape, to run it will require that 
the modem used to capture it will 
need to be present to run any pro- 
gram. As each modem has a unique 
ID embedded in its firmware this 
scheme offers a high degree of pro- 
tection against unauthorised copy- 
ing of any programs, 


More MSX news — details 


still scarce though 


The companies behind the MSX 
computer standard are at last reve- 
aling more details as to their pricing 
policies and launch dates. The 
releases from the likes of Toshiba 
and Sanyo still abound with phrases 
such as ‘the price is expected to be 
...', ‘retail price will be around...’ 
The signs are though that a typical 
MSX machine will cost £300 and 
that the first hardware will be in the 
shops in September. Toshiba are 
still favourites to win the race to the 
High Street but the others are 
unlikely to be far behind with Sanyo 
promising October delivery. 


Out foxing 
the BABT 


We hear that at least one multi- 
national company with a stake in the 
home computer market is putting 
some experimental hardware 
through the BABT approval proce- 
dure. Apparently the firm are being 
rather coy when it comes to the full 
potential of the silicon contained 
within the prototypes and are taking 
a softly softly approach to the prob- 
jems of getting equipment type 
approved, 

This particular company also 
have a UK manufacturing facility 
and this makes the problems of 
obtaining approval for production 
machines a much simpler process 
than is the case with firms making 
use of overseas production 
facilities. 

The prospect of a low cost com- 
puter, complete with _ built-in 
modem, now looks a real possibility 
within the very near future. 


Tangerine 
6809 add-on 
board is FLEX 


compatible 


The Tangerine Computer can be 
transformed into a fully fledged 
FLEX system with the addition of 
Ralph Engineering's 6809 card. A 
Tangerine Computer equipped with 
the card does not suffer from the 
limitations of the Dragon computer 
when running under the same 
operating system. Installing the 
card converts the Tangerine into a 
fully functioning FLEX system and 
not just a terminal talking to a 6809 
card. 

Ralph Engineering, Forncett End, 
Norwich, Norfolk. 095389 420. 


Statement 


The publishers of Electronics and 
Computing Monthly, EMAP Busi- 
ness and Computer Publications 
would like' to point out that the 
appearance of an advert within 
E&CM does not imply that the pub- 
lishers condone or encourage any 
views or beliefs that may be por- 
trayed by companies or organisa- 
tions purchasing advertising space 
within the magazine. When confu- 
sion between paid for advertising 
and editorial matter is likely to 
occur, any paid for space will be 
clearly headed with the word 
ADVERTISEMENT. 

The publisher. 
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PORT 
MASTER 


Just the program you need in order to use a 
control interface with the BBC micro without 
the hastle of configuring the VIA’s Data 
Direction register. Mike Williams explains. 


More and more BBC computer owners are 

becoming interested in using their machine 
| to interact with the outside world. They 

also want to explore the world of Robotics 

and Control as well as the sensing of temp- 
) eratures, light levels, sounds and so on. 

In Primary Schools very young children 
are using computers to switch lights on 
and off. A simple light sensor tells the com- 
puter when it is getting dark, and on go the 
lights. Traffic light systems can be simu- 

| lated and some Logo type languages are 

| coming along to control these systems 
without involving the children in the 
intricacies of BASIC syntax. 

In order to connect up the computer with 
sensors or motors, some sort of interface 
beard is usually built or purchased. This 
board normally plugs into the User Port 
and typically may allow four sensors to be 
read by the computer and four relays to be 
switched on and off. Many magazines have 


To illustrate the operation of the Port 
Master software, we hooked up Pilot One's 
Interface (reviewed in the current issue of 
Your Robot) to the office BBC micro, and 
put the routine through its paces. 

The interface requires that lines PBO, 
PB1, PB2, and PB3 are configured as out- 
put lines and that the other four lines (PB4, 
PB5, PB6 and PB7) are set up as inputs. 
The Port Master software was loaded and 
the I/O lines were set to the correct status 
after answering no to the initial prompt 
which asks whether or not the software 
was configured for correct operation. Set- 
ting the lines was straightforward and after 
this initial step the screen will display the 
four digit hex number that, when placed in 
line 410, would tailor the Port Master to the 
conditions required by Interface. 

By selecting the toggle option from the 
Port Master menu, the four relays of Inter- 


given instructions on how to build such a 
board, and they are also available com- 
mercially. (If you do connect straight to the 
User Port, without an interface board, then 
you run the risk of blowing up some expen- 
sive chips inside your Beeb!). 

Having got the interface board however, 
there comes the problem of what is called 
‘configuring the Data Direction register’ of 
the User Port VIA. Now if that is goblede- 
gook and you have no wish to delve into 
hexadecimal code too deeply, then this is 
just the program you need. The Port 
Master allows you to: 


set up the interface board; 
decide the inputs and outputs; 
switch the relays on and off; 
monitor the inputs. 


with only the bother of typing in the pro- 
gram. 


Pilot one's interface. 


face could be switched on and off — the 
switching action being confirmed both by 
the interface’s mimic LEDs and the Port 
Master screen display. 

The input lines of Interface feature a 
schmitt trigger input which means that they 
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pri oduced by the tog 


The screen display 
below. 


ean be used both with ordinary switches or 
with photodiodes, LDRs, thermistors. etc. 
To confirm the operation of the input fines 
Interface was connected to a motor driven 
crane that was supplied by Pilot One as 
part of their review package. This featured 
an optically encoded disc that provides 
positional information as the crane’s turret 
is rotated. Using a suitable combination of | 
output lines, the turret was rotated and the 
pulsing ‘LED’ on one of the input lines dis- 
played by Port Master confirmed that input 
monitoring was being performed by the 
software. 

Port Master provides a quick and effi- 
cient: means by which the input/output 
lines of any interface can be monitored. It 
should prove a useful addition to the soft- 
ware collection of anyone using their BBC 
micro. to investigate the field of computer 
control. 
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PROJECT 


100 REM REESE AAERE ARERR RE 
110 REM * PORT UTILITY *# 
120 REM x by ‘ 
130REM * M.E.Williams * 
140 REM SPER ATAAAA AR EET E TE 
150 

140 ON ERROR GOTO 1250 

170 

180 PROCinit 

190 MODE1 


200 -VDU23; 8202; 0;0;0;: REM remove cursor. 

210: PROCGOnFigure-4 REM set up the Data Direction Register. 
220 

230 REPEAT 

246 MODE7:FROCmenu 

25° MODE 1: VDU23; 8202; 0; 0; 0; 

260 IF In$="R" THEN PROCconfigure 

276 IF In$="0" THEN outsFALSE 

280 IF: Int="T" THEN out=TRUE 

296 IF. In$<>"0"% THEN PROCread port 

300 UNTIL in¢="0"sMODE7: END 

sid 

320 

S30 DEF PROCinit 

340 @%21:"TVO,1 

3SO-4 

360: VDUZS, 225, 127,127, 1275127, 127, 127,127, 127: REM led 
370 portB=tFE6O =: REM PortB port address. 

380 pbhdd=tFE62 + REM PortB Data Direction register. 
390 DIM block% 9 : REM used by double sized letter procedure. 
400 out=FALSE 

410 ENDPROC 

420 

430 DEF PROCcOonfigure:LOCAL N%,J% 

440 CLS 

450 PROCdouble("” Are you using the interface board?") 


460 IF FNy_nm THEN ?pbdd=8FO:CLS:ENDPROC 

470 REM The default interface board has O12> Inputs, 4567 Outputs. 

480 REPEAT 

490 CLS:PROCdouble(" Select input <I> output <O>") 

500 PROC] eds (25) “ 

S10 REM Now get the appropriate number,N%,for Data Direction 
register. 

$20 N%Z=0 

530 COLOURI 

S46 FORJ%=8 TO 1 STEP-1i:PRINTTAB(285%.5)5"7" 


550 Ins=GETS 

560 IF In$="0" THEN NZHN%4+2* (8-J%) : PRINTTAB(24I%,2)3"0" ELSE IF 
Ins="I" PRINTTAB(24I%,3)3 "I" ELSE GOTO S50 

570 NEXT 


580 COLOURS 

S96 VDU26 : REM Reset window. 

600 PRINTTAB( 14,29); 

610. PROCdouble("Is this OK 7? ") 

620 UNTIL FNy_n 

630 ?Ppbdd=N% 

640 ENDPROC 

650 * 

650: DEF -PROCTeds(y_ pos) + REM print boxes tor “leds* and: frame. 

670 FOR J%=1 TO 8 

680 PROCHox (10+2#3%, y_pos, 1,1, TRUE) 

690 NEXT 

700 PROCbox (10, y_pos-3, 19,5, TRUE) 

71@- FORIZSO 10:7 ; 

720 PRINTTAB(2+243%, 1) 7-3% 

730 NEXT 

740 ENDPROC 

750 

760 DEF PROCread_port 

770-CLS 

780 PROCdouble(” Current: Fock status") 

790 PRINT: PRINT 

800 PROCdouble(" haan Sk wae ald Sat am win a a3 

8160 IF out THEN PROCcenter ("(To toggle output, press number.)”, 5) 

820 COLOURZ 

650 PROCcenter(” Frese “SPACE BAR> to return to Menu." , 207 

B40 PRINTTAB(14,9)3 

850° PROCdOUble ("fC pbdd=&"+STRS™ (?pbdd) +" 1") 

840 GCOLO,2 

870 PROC eds (15) 

S80 COLOURT 

890 statust=?pbdd 

FOO + 

910 REM check input and output lines and print on .screeen. aa 

920 FORIZ“Z=1 TO 8 

930 IF (status% AND 2°(3%4-1)) THEN PRINTTAB(18-249%,3);"0" ELSE 
PRINTTAB( 18-240%, 24 "T" 

940 NEXT 

950 COLOURS < 

$66 GCOLO,3 

970 PROCleds(25) 


m5 ee Qh Gy EF gy hess xr ot MR RESTA GF Bogie bow ecm! ayes ou ses 
fat 380 REM Indicate state of port using red legs’. 
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When the program is run, the user is 
asked if he/she is using the interface 
board. This refers to the board which will 
be attached to the port, and assumes that 
the Port Master has been run before and is 
now tailored to the board. If the interface 
board is being used for the first time then 
enter ‘no’ here. You will then be asked to 
select which of the port terminals are to be 
used as inputs and which as outputs. The 
instructions with your board should make 
the choices clear to you. 

The options shown in the menu are now 
presented. 


Reconfiguring the port 
Means changing the arrangement of inputs 
and outputs. 


Toggle the outputs 

Produces the current port status display. 
The top box shows which of the 8 terminals 
in the User Port are outputs and which are 
inputs. The lower box shows the actual 
state of the terminals — either at OV or at 5V 
(shown by the red ‘led’). 

The number following the pbdd= in the 
yellow brackets is the number which 
should be in line 460 if the program is to be 
customised for your own interface board. 
For those versed in the mysteries of the 
User Port (lucidly explained by Paul Bever- 
ley in the June edition of Electronics and 
Computing Monthly the number describes 
the contents of the Data Direction register. 

The outputs can be changed by pressing 


the corresponding number key. Of course 
pressing the key of an input has no effect. 


Observing the port state 

This is the same as the previous ption but 
without the possibility of changing any out- 
puts. 

The program is liberally sprinkled with 
REMs and is fairly well structured. For 
those interested | give a brief description of 
the procedures used. 


PROCinit 


Sets up some variables. 


PROCmenu 


Produces the menu display. It uses some 
nice Mode 7 procedures at lines 1500 
onwards. 


PROC configure 


Arranges the contents of the Data Direc- 
tion register. In other words it tells the User 
Port which of its lines are inputs and which 
outputs. The default value | have given is 
&FO. This gives four inputs and four out- 
puts. If you are reconfiguring the port (or 
you answered ‘no’ at the start of the pro- 
gram) then the loop from lines 480 to 620 
calculates the appropriate number for you. 
To understand how this works, go back 
and reread Paul Beverley and all should be 
clear. 


PROCleds 

Draws the boxes which contain the red 
‘leds’ and the | or O letters. It calls PROC- 
box which in turn calls PROCwindow. 
These are super procedures which draw 
frames around text windows of any size. 


I'm sure you will find them useful. 


PROCread_port 


This produces the port status display. 
The instruction concerning output toggling 
only appears if option T has been selected 
(in which case variable ‘out’ is TRUE). 

The program probably spends most of 
its time in this procedure and in particular 
in the loop at lines 1010 to 1080. The faster 
the program gets through this loop the 
more immediately it will respond to any 


change. For clarity | have spread things 
out, but for speed you could remove the 
REM and squash some of the lines 
together. But BBC BASIC is so impres- 
sively fast that | doubt if you will need to. 

If you try to toggle an output then PROC- 
out first checks with the data direction 
register to see if you are trying to toggle an 
input. Such impudence takes you out of 
the procedure. Otherwise you get a con- 
firming beep and lines 1140 to 1160 effect 
the change. 


a 


moa 


} 
3 
; 
: 
‘ 
i 
‘ 
} 
: 


: 
: 


FEATURE 


BASIC is an excellent programming 
language; it is easy to use and well suited 
to the range of applications for which home 
micros are used. But no matter how excel- 
lent the language and how experienced the 
programmer, “bugs” — program errors and 
misbehaviour — are a fact of life. 

Every programmer has to learn to deal 
with bugs in one way or another, but it is 
surprising how often debugging is carried 
out in a haphazard and non-systematic 
way. No-one would dispute that pro- 
gramming is, fundamentally, a logical 
activity but when it comes to bugs every- 
thing seems to go haywire along with the 
program. Perfectly rational programmers 
seem to believe that bugs are best dealt 
with by inspiration and divine guidance — in 
practice the only thing that this approach 
achieves is a great waste of time. 

It is often difficult to see how finding a 
particular bug in a program running on a 
| particular machine can possibly be 
i.generalised and a lesson learnt that will 
help with finding future and very different 
bugs. To a certain extent this is a real diffi- 
culty, but there are general principles that 
lie behind debugging and there are specific 
types of fault that tend to occur in any given 
language. 

The first part of this article deals with 
general principles of debugging a program 
and the second part discusses some of the 
most often encountered mistakes in 
BASIC. Notice that this list of common 
errors is by no means complete because 
there is a personality factor which causes 
some programmers to be prone to certain 
errors that other programmers never seem 
to make. 


Just looking 


The most common approach to finding 
bugs is the “just looking” method. What is 


ed 


Mike James shows that, by adopting a 
systematic approach to program 
debugging, the task can be made very much 


surprising is that a simple examination of 
the listing of the program does in fact solve 
most of the bugs that crop up in the early 
stages of program development — this is 
simply a consequence of such bugs being 
very simple and very obvious. The danger 
is that this early and powerful success of 
the “just looking” method results in it being 
used in situations where it is totally ineffec- 
tive. 

If you have detected a bug by way of the 
program misbehaving or by getting an 
error message, then by all means examine 
the program, using any knowledge that 
you may already have to narrow down the 
area that you look at, BUT if this doesn’t 
reveal the source of the error in a few 
minutes then move on to the logical 
debugging methods described below. 


e 
Debugging — Rule One 
If you fail to find the problem after a few 
minutes DO NOT continue simply to stare 
and ponder over the listing. There is only a 


Sea EE Me 


what information is required? Although you 
may think that the answer to this question 
would be difficult it is quite straightforward 
and precise. There are only two compo- 
nents to the way a program works; the 
values stored in its variables and the order 
in which its instructions are carried out, 
and these two components are also 
responsible for the way a program fails to 


If you know what values should be 
stored in a program’s variables and in what 
order its instructions should be carried out 
(and you discover that your predictions are 
correct) then the program is working. On 
the other hand, if the program disagrees 
with your predictions then it is clearly not 
working as intended — that is, it contains a 
bug. The first place that the program dis- 
agrees with your prediction is the most 


“general principles lie behind debugging and 
specific faults that occur in any language”. 


very limited amount of information a listing 
can give you about how the program is 
working — after all itis a “static” representa- 
tion of a “dynamic” program. Put simply — 
to effectively debug a program you need as 
much information about how your program 
is working as yqu can easily obtain. In this 
sense debugging is an active rather than a 
passive examination of the program. To 
debug quickly and efficiently you have to 
hunt and trap the bug rather than just wait 
for it to show itself as the result of inspira- 
tion. 

The need for information about how a 
program is running is obvious, but exactly 
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likely place for the bug to be situated. 

Putting this theory into practice is quite 
simple. If your program misbehaves and 
you cannot immediately see what the 
problem is, then you have to begin the pro- 
cess of predicting the values stored in each 
of its variables and the order that its state- 
ments will be carried out, then compare 
these predictions with reality. 

To find out what is really stored in a vari- 
able is a matter of temporarily adding a 
PRINT statement to the program to print 
out the current values that each variable 
holds. In practice it is usually fairly easy to 
avoid the information overtoad produced 
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by printing the values stored in every vari- 
able; this is done by picking a small 
number of variables that are obviously 
important. The order that statements are 
executed in can also be discovered by 
adding temporary PRINT statements 
which display the next or their own line 
number. 

Once again in practice the information 
overload produced by printing a message 
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just before each line is executed can be 
avoided by just adding PRINT statements 
to show which way the program went fol- 
lowing each iF statement. Only where an IF 
statement presents a choice of statements 
to be executed is there any doubt about 
the order in which they are carried out — 
although see the “fall through” error 
described below. 

The art in using logical debugging is to 
get exactly the amount of information you 
require and no more. For example, if a pro- 
gram presents the user with a selection 
from a menu but fails to jump to the correct 
choice, then clearly you are interested in 
finding out the value of the variable used 
within the program to record the user's 
selection and no others. If the value in this 
variable is correct, then you must examine 
the exact order that statements within the 
menu section of the program are carried 
out. Are they ever executed? Does the pro- 
gram always follow the same route? Does 
the program go to the correct option and 
then jump somewhere else . . .? Notice that 
it is important to predict what you expect 
the program to do BEFORE you examine 
what it does. The reason for this is that 
most programmers believe in their pro- 
gram to the extent that they are too willing 
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to assume that it is correct! 

The second rule of debugging is to pre- 
dict the values stored in each variable and 
the order of execution of each statement, 
and then check that this IS how the pro- 
gram works. 

As already described, in practice things 
are not quite so bad in that you do not have 
to predict and examine all of the variables 
and all of the statements if you have some 
idea where the bug is in the program. 

‘This is all that there is to logical debug- 
ging — easy isn’t it? What is surprising is 
how keeping the principle of logical debug- 
ging in mind can make the task of finding 
bugs easy. Even though this principle of 
debugging can and should be applied to 
programs written in any language, it can 
save a great deal of time if you are aware of 


_tht: most probable types of errors to which 


each language gives rise. As already men- 
tioned, BASIC is a good language but it has 
its faults, and the time has come to 
examine them — starting with the most 
serious. 


The trouble with line 
numbers 


A whole family of errors and problems arise 
either directly or indirectly from BASIC’s 
dependence on line numbers. In nearly all 
versions of BASIC (there are one or two 
exceptions) each line in a program must 
have a line number. This is so much part of 
the BASIC language that BASIC program- 
mers rarely stop to question if so many line 
numbers are really necessary. BASIC line 
numbers serve two purposes — as con- 


“lt is important to predict 
what you expect the 
program fo do BEFORE you 
examine what it does”. 


venient “markers” for editing program lines 
and as ‘labels’ that are used by GOTO and 
GOSUB commands. It is clear that, as far 
as editing is concerned, every line must 
have a line number for the method to work, 
but for the use of GOTO and GOSUB the 
only lines that NEED line numbers are 
those that are actually referred to in GOTO 
or GOSUB commands. 

There are many reasons why the dual 
function served by line numbers causes a 
problem in the easy production of clear 
and bug-free programs. 
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The line misplacement problem 


The fact that every line has to have a line 
number which determines its position 
within the program is a mechanism that is 
very sensitive to typing errors. You only 
have to mistype a single digit and, not only 
does a line appear to be missing at one 
position, an extra line appears elsewhere, 
possibly in part of a program that was 
finished and debugged some time before. 
In this sense, typing a single digit incor- 
rectly destroys the overall correctness of 
the program and introduces a very difficult 
bug, lurking in a part of the program that 
you have tested and is therefore almost 
above suspicion! 

\f a program worked until you typed in a 
few extra lines, then suddenly goes ber- 
serk, it is worth checking that all the lines 
you entered are present where you expect 
them to be. If you type in a line and it goes 
missing then don’t simply type the line in 
again — find out where it has gone and get 
rid of it. Also, the line misplacement prob- 
lem is a good reason for not typing in many 
lines of a program at a time. Type in a small 
block of lines and then check that they are 
all present and correct. 


Fixed destinations 


When a line number is used in a GOTO or 
GOSUB statement then it is an advantage 
if it remains unchanged throughout the life 
of the program. The reason for this is that 
the line number of the destination of a 
GOTO or GOSUB serves to ‘name’ a part 
of the program that performs a particular 
task. If this ‘name’ changes during the 
development of a program then it is pos- 
sible that the programmer will incorrectly 
use the ‘old’ value instead of the correct 
new value when re-using that part of the 
program. 

For example, if during the initial 
implementation of a program, subroutine 
1000 prints an opening message then you 
are likely to use GOSUB 1000 later on to 
print the same message. If, however, in the 
intervening time it has been necessary to 
renumber the program so that extra lines 
can be inserted, line 1000 may be assigned 
a value, say 1370. 


The forward jump problem 

When writing a program, it is easy to use a 
GOTO statement to transfer control back 
to a point earlier in the program. The 
reason for this is that it is usually the earlier 
part of the program which is already written 
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and it is very easy to find the line number of 
the point to which you want to return. This 
should be compared to the situation when 
using the GOTO to transfer control forward 
to a line later in the program. in this case 
the chances are that the line to which you 
are trying to transfer control has not yet 
been written. The line number that will 
eventually be assigned is difficult to work 
out, as it depends on the number of state- 
ments that will be written and the line 
number increment in use. 

The best solution to the forward jump 
problem is not to make a guess at the line 
number, but to use a symbol such as “*” to 
indicate that you have to return and fill in 
the missing number. If you guess the line 
number, it is possible that you will get it 
wrong and this will go undetected 
because, even though the line number you 
used was incorrect, the GOTO is still valid 
BASIC. If you use “*" to mark incomplete 
GOTO statements it is impossible to forget 
them as they will cause the program to 
crash if not removed! 

It is possible to imagine a version of BBC 
BASIC that doesn’t use line numbers for 
editing. Program lines could be entered, 
deleted, listed and modified by use of the 
cursor keys instead. This would indeed be 
a great improvement in that the confusion 
and difficulties that result from the dual use 
of line numbers would be completely elimi- 
nated. Failing this, the best course of 
action would be to try to avoid the use of 
line numbers within GOTO and GOSUB by 
making GOTO redundant and by replacing 
the GOSUB with a PROC call as in BBC/ 
Acorn or QL Super BASIC. 


In and out of FOR loops 


FOR loops seem to cause rather more 
trouble than they should, perhaps because 
their purpose is not always made clear in 
introductions to BASIC. A FOR loop is 
intended to be used whenever a group of 
statements needs to be repeated a given 
number of times. This is simple enough, 
but it often becomes confused with the 
closely related ‘conditional loop’ — that is 
repeating a group of statements until some 
logical condition is satisfied. The result of 
this confusion is the tendency for BASIC 
programmers to jump out of FOR loops 
before they are properly complete. For 
example, consider the problem of scan- 
ning a string to find the first occurrence of 
a particular letter or, failing that, the end of 
the string. This is most often programmed 
something like: 


1000 FORI=1 TOLEN(S$) 

1010 IF MID$(S$,1,1)=T$ THEN GOTO 
1030 

1020 NEXTI 

1030 rest of the program 


where S$ is the string to be searched for 
the character in T$$. In many versions of 


BASIC this will result in the program crash- 
ing; even in those versions of BASIC where 
this is allowed it is still poor programming 
style. The point about FOR loops is that 
you should be able to work out how many 
times they will repeat by looking at the FOR 
statement itself (line 1000 in this case) and 
not have to worry about statements within 
the loop. The jump out of the FOR loop at 
line 1010 is not only confusing but leaves 
the loop unfinished and most versions of 
BASIC cannot deal with an unlimited 
number of unfinished FOR loops. The pre- 
mature exit from a FOR loop will eventually 
crash the program. 

A solution to this program that is often 
used, and even advocated as a sign of 
advanced programming technique, is to 
set the index variable equal to the final 
value and then jump to the end of the FOR 
loop. In the above example this would 
mean changing line 1010 to: 


1010 IF MID$(S$,1,1)=T$ THEN 
L=1:I=LEN(S$) 


Lis used to save the position of the charac- 
ter in the string and then | is set to a value 
that will cause the FOR loop to end natur- 
ally. Unfortunately, although this does stop 
the program from crashing, it is still not 
good programming practice — it results in 
programs that are “unstable” in the sense 
that a small change in the way that the FOR 
loop is implemented, or in the program 
itself, can create a bug. The rule is that you 
should never jump out of a FOR loop and 
you should try to avoid bringing a FOR loop 
to an early end. It has to be admitted that 
sometimes a particular dialect of BASIC is 
so inefficient that you do have to resort to 
tricks of this sort to make a loop run fast 
enough — but then good programming is 
often about making a trade-off between 
efficiency and good style. 


The fall through problem 


The fall through problem is something that 
every programmer has experienced in 
BASIC. At its simplest it is caused by 
forgetting to put a GOTO, END or RETURN 
at the correct place in a block of state- 
ments. For example, if you forget to com- 
plete the main program with END then after 
you have completed a RUN, instead of 
halting, the program will “fall through” into 
the first subroutine following the main pro- 
gram. As this subroutine is often the first 
that the main program cails, it can appear 
that something very strange has happened 
and the program is trying to run itself from 
the beginning again! 

In the same way, not ending a subroutine 
with a RETURN causes the next subroutine 
to be entered without being called from the 
main program. This also usually results ina 
subroutine being mysteriously called 
twice! 
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The, final type of fall through problem 
often arises because of the tendency to 
forget to skip over a block of statements 


_ that you do not want to be executed. For 


example, if you want to execute “list 1” of 
statements if A is positive and ‘list 2’ of 
statements if A is negative then the correct 
way is to use something like: 


1000 IF A>=0 THEN GOTO 1500 


list 2 
1490 GOTO 1600 
1500 . : 
list 1 

1600 rest of BASIC program 

where line 1000 skips “list 2” if A>=0 and 
1490 skips “list 1” if A<O. The most com- 
mon error is to forget to enter line 1490 and 
so “list 1” is executed whenever “list 2” is— 
in other words “list 2” falls through to “list 
1” without line 1490. There are plenty of 
other examples of the fall through bug but 
they can all be found by tracing the flow of 
control. Looking out for them, however, 
can save some time. 


Expressions 

@,0 
and conditions 
Expressions and logical conditions form 
the main way that anything useful gets 
done in almost all computer languages. It is 
surprising to say that; even after many 
years of programming; it is still possible to 
be confused by the slight differences 
between the BASIC form of writing arith- 
metic and logic and the English way. For 
example, if you try to convert the formulae: 


1 


y(1+X) 

into BASIC be careful not to write: 
1/Y*14+X 

or even 
1/Y¥*(1+X) 

the correct form is (of course) 
1/V/(1+X) 


but the double use of the divide symbol 
makes it look odd. Logical expressions can 
also be confusing. For example, if you want 
to check that the answer to a question was 
either “YES” or “NO”, then you might use: 


IF A$<>“YES” AND A$<>“NO” THEN 
GOTO error 


Many programmers consistently write OR 
in place of the AND in this logical expres- 
sion. The moral of both these tales is not so 
much that you should look out for these 
particular xamples; it is much more that 
you should never assume that an expres- 
sion of any sort actually calculates what 
you think it does! In other words, the 
“checking values” part of logical debug- 
ging is something to take very seriously ~ | 5 
even when you are convinced that you }{ 
know the answer, 
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The EPROM simulator is a small pcb card 
which contains ten standard logic and 
memory chips and which behaves as 
though it were a 4K Eraseable ROM. It can 
be attached to a single computer or it may 
link one computer to another system. In 
either case it acts as a convenient buffer 
between the controlling system (CON- 
TROLLER) and the system under develop- 
ment (RECEIVER) (see Figure 1). 


Essential test equipment 


Suppose a stand-alone logic unit is being 
designed to control the total environmental 
conditions of a greenhouse. The unit will 
consist largely of input and output devices 
and naturally a CPU and ROM will handle 
| the decision-taking and control the whole 
show. Generally, the minimum amount of 
equipment which would be needed to 
develop such a system would be: 

1 A computer with an Editor/Assem- 
bler for writing the greenhouse software. (A 
cross-assembler would be needed if the 
computer's CPU has a different instruction 
set to that of the greenhouse CPU). 

2 An EPROM programmer to blow the 
software into one or more EPROMs. 

3 An ultra-violet light-box for erasing 
all the EPROMs that didn’t work first time. 

The EPROM simulator helps to develop 
the new system in two very important 
ways. The ultra-violet hardware may be 
dispensed with altogether, and the time 
taken to develop and blow a bug-free ROM 
can be drastically reduced. When you con- 
sider that it may take about ten minutes to 
set up and blow a ROM and thirty minutes 
to erase it again, and that the system may 
not work until version twelve of the soft- 
ware has been evaluated, it is likely that 
human patience and the physical strength 
of the EPROM will begin to wear thin! 


| Interfacing the simulator 


EPROM SIMULATOR — _ 
AID TO M/C DEVELOPMENT 


Richard Sargent and Robert Harvey describe an EPROM simulator | 
that can dramatically reduce the time taken to develop machine 
code programs. The project was designed to offer maximum 
flexibility combined with ease of use. 


EPROMs and connects to the RECEIVER 
system by ribbon cable into the ROM 
socket. The CONTROLLER loads software 
into the unit by means of a standard Cen- 
tronics parallel interface. 

The software under development can be 
downloaded from the controlling computer 
to the receiving system in a matter of 
seconds. This allows small test routines to 
be devised and placed quickly into the new 
system for part-testing of various circuit 
elements. Patches of code can be easily 
tagged onto the software under develop- 
ment, or parts of the coding may be over- 
written. All this can be done easily and 
quickly and with no swopping of test leads 
or unplugging of ICs. 


The hardware 


The circuit is based around 4K of CMOS 
RAM, the contents of which simulate the 
EPROM of the system under evaluation. 
Two HM6116P-3 devices were used in the 
prototype. These are 2048 X 8-bit high- 


speed static RAM chips, capable of retain- | 
ing their data on a standby voltage of 3.0V |# 
whilst drawing a 1004W current. They are |> 
made by Hitachi and versions with an | 
access time as fast as 200ns may be | 
obtained. The pin designation is com- 
patible with the standard 2K ROMs, [7 
although that is of no significance in this | 
particular circuit design. The pins are TTL } 
compatible. e 
The block diagram (Figure 2) shows the |; 
principle of operation, with the RAM - 
occupying the heart of the unit and data 
entering from the controlling computer on 
the left and passing out to the development 
system on the right. Data flow is controlled 
by SW1 and timing is controlled by the STB 
signal. Moving on to the circuit diagram 
(Figure 3) SW1 marks a convenient start- 
ing point for explanation. By controlling the 
chip-enable pin of IC3 and the address 
information through logic switches IC5, 
IC6 &1IC7, the EPROM simulator can be put 
into one of two modes: Receive software 
(LOAD) or Simulate Eprom (SROM). 


CONTROLLER [J 
OL too 
| RECEIVER 


| The unit can simulate 2708, 2716 and 2732 | Figure 1. The relationship between the various items in a typical application. 
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Fhe parallel interface provides the data 
guentially one byte at a time, and the 
dress of each data byte is generated by 
“CMOS counter 4040 (IC8). Three 
415157 multiplexers (ICs5,6,7) take 
iddress information either from the 
‘er (LOAD mode) or from the address 
jis of the EPROM socket (SROM mode). 
When SW1 is put into LOAD mode the out- 
ut of IC9A becomes low, allowing the 
gentronics data to pass through buffer IC3 
onto the RAM data bus. IC10C illuminates 
ED D7 which indicates the LOAD mode. 
fhe multiplexers are correctly set, and the 
prentiator network R3/C1/D1 provides 
‘spike pulse to the re-set pin of the 
iddress counter. Notice that the write en- 
le (pin 21) of the RAM (ICs 1 & 2) is only 
habled when the strobe pulse from the 
tronics interface occurs. This strobe 
st be a low going pulse and the parallel 
data must be valid for the duration of the 
Pulse. The duration of the pulse should be 
little longer than the access time of the 
, 80 300nSec should prove to be suffi- 
Gent. The strobe is inverted by IC9C and 
i ents the address counter IC8. On 
the count of 2048 the first RAM chip (IC1) is 
sompletely loaded with data and for the 
next 2047 bytes the high on pin 1 or IC8 will 
close down IC1 and allow the second RAM 
chip (IC2) to be loaded with the final 2K of 
data. Software should ensure that the 
transfer of data stops after 4K bytes have 
been transmitted, but if there is any “over- 
yun”, perhaps caused by the occasional 
“spurious pulse then pin 1 of IC8 will go low 
and this condition can be reported on the 
“BUSY line of the centronics interface. 
» The EPROM simulator connects to the 
recipient ROM socket via a 24-way DIL 
wheader. The EPROM’s OE and CE signals 
sare brought to 1C10B and when low they 
‘enable the uni-directional tri-state buffer 
4C4. There can never by any contention on 
‘the simulator bus between signals from the 
controlling and receiving systems. 


Three rail EPROMs 


The EPROM simulator caters for all types 
of 24-pin EPROM. The 2708 and 2716 
types are seldom advertised these days, 
but it is likely that a great many “second- 
hand” devices will be available on the 
hobby market for some years and you 
might find yourself using them. The +12 
and —5 voltages from the EPROM socket 
would normally ruin the TTL in the 
simulator, so the protection network of D5, 
D6, R6 and R7 has been included on the 
address lines 21 and 19. The network is 
transparent to the normal high/low transi- 
tions of 5volt TTL, but when a three-rail 
device is connected pin 19 (EPROM 
socket) is read as TTL high and pin 21 is 
read as TTL low by the simulator. This 
leads to a rather strange mapping of the 
three-rail EPROMs onto the 4K RAM of the 
simulator because the extra voltages on 
the one type of EPROM are on the same 
pins as the address information of the 
larger capacity EPROMs, and 2708 data 
needs to be stored in the second 1K block 
of IC1. 


Controlling the card 


The prototype EPROM simulator has 
worked well from a Centronics interface 
where BUSY is tied LOW and ACK is tied to 
STB. 4K blocks of data move without error 
from the controlling computer to the 
simulator card. The purpose of LK1, LK2 
and LK3 is to make the card as flexible as 
possible so that it can work from control- 
ling computers where the information 
relating to the Centronics interface might 
be vague or missing altogether. A different 
approach would be to send the developed 
software out through the Centronics port 
using a purpose-written machine-code 
program with the BUSY (or the ACK) line 
testing for an over-run condition as 
previously explained. 

For computers which have no parallel 
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Figure 2. Block diagram of the system showing the RAM is the centre of the design. 
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output port |C10D and LK3 have been pro- 
vided to allow experimentation using the ff 
PORTSEL (port select) line. Remember |= 
though that IC3 is a buffer rather than a } 

latch, and that any signal fed to PORTSEL 
should only go low at the controlling CPU’s |} 
WRITE time and at MREQ (or IORQ) time. 
The CPU WRITE strobe (NWRS) may be 


tried as the strobe signal to the Simulator | 


board, but close attention would have to 
be given to the timing waveforms of the 
CPU. It is probably easier in the jong run to 
make up a 9-bit output port to interface 
between the controlling computer and the 
simulator card. 

Normally the EPROM simulator takes its 
power from the supply pins of the EPROM 
socket, but a Nickel Cadmium recharge- 
able battery is used to power the RAM 
when the receiving system is powered 
down. This is essential if the receiving 
system uses the “switch of the power” 
method of RESET. (E&CM readers 
wouldn’t do that surely!) The NiCad is 
trickle-charged via R5 and D3 when power 
is applied to the circuit, and care should be F 


taken to ensure that the NiCad is suffi- | 


ciently charged before pulling out all the 
plugs. The enable switch SW2 should be f 
closed prior to any intended battery opera- 
tion. There is no reason why the power 
supply should not be taken from the con- 
trolling computer, and link LK2 allows for 
this. Care should be exercised so that the 
EPROM simulator does not take its power 
from both systems simultaneously, and 
that the power supply driving the simulator 
is not overloaded by the extra demands of 
the simulator ICs and NiCad charger. 


Construction and testing 


Construction is reasonably straightforward 
if the printed circuit board is used. The 
CMOS ICs must be socketed and should 
be placed into the board last, observing the 
usual handling precautions of earthing 
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Figure 3. Full circuit diagram of the EPROM simulator. 
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»| Overlay of the EPROM simulator project. PCBs are available from E&CM — those people wishing to 
=| make their own boards should send a large SAE to our offices for the foil pattern. 


=| Static electricity before they are removed 
=| from their conducting-foam packing. Note 
| that the orientation of |C3 and SK2 differs 

) from the rest of the chips. The battery, 
switches and LED may be mounted on the 
board or else flying leads may be taken 
from the board to these components. The 


*) IC sockets should be soldered onto the 
} board first — be sure that SK1 and SK2 are 


of the type that will accept their 16 and 24- 
pin DIL headers before you solder them in 
— followed by the wire links, of which there 
are many. The components should go in 
next, and links 1 to 4 wired up. It is vital that 
the wire link/component overlay is con- 
sulted as the building proceeds. LK5 pow- 
ers up the CMOS sockets, so you might 
like to leave that until last. The computer 
end of the 14-way ribbon cable should be 
connected to whatever plug or socket the 
parallel interface uses. The normal wiring 


convention for the Centronics standard is 
shown in Figure 4 and this is what you 
might reasonably expect at the computer 
end. The ribbon cable cannot follow this 
convention entirely and note too that there 
is the non-standard signal called 
PORTSEL which is intended to help non- 
Centronics users. The wiring of the link 
pads needs some care, LK4 gives the 
simple option of taking the 5V power 
supply from a source other than the 
EPROM socket. LK1, LK2 and LK3 control 
the BUSY, ACK and PORTSEL options 
respectively and in each case the normal 
link will be A to B. 

Complete the board with the exception 
of the ICs themselves and double check 
the polarity of the electrolytic capacitors 
and the diodes. Apply +5v to pin 24 and Ov 
to pin 12 of SK1. Establish that the power 
supply is available at all IC sockets, and 
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that on IC1 and IC2 SKTs the Vdd is about | 


4.3v (0.7v is dropped across D4). Remem- 


bering to turn off the power before insert- [7 
ing or removing any ICs, first putiniIC9 and ff 
IC10 and establish that the LOAD LED | 


comes on when SW1 is operated. The |/ 
remaining ICs except IC1 and IC2 may be 
inserted, and a check made on the logic 
operation of the counter and the multiplex- 
ers by manually clocking STB using the 
small test circuit (shown on the main circuit [7 
diagram) and checking a few outputs of 
IC5 with a logic tester or voltmeter. Finally, 
if all seems well put in the memory ICs (just | 
IC1 will do to start with) and begin sending 
test bytes from the computer to the card. 


Obviously if the same computer has a |) 


spare EPROM socket and can read back 


the data from the 6116, then the job willbe [7™™ 
made so much easier. Don’t forget to test [7 


the battery back-up upon data that doesn’t 
really matter. A newly purchased NiCad 
will take many hours on trickle charge to 
come up to full voltage. 


Centronics signals 
Pin1 

Pins 2-9 

Pin 10 

Pin 11 

Pin 32 

Pin 16 

Pin 33 

Pins 19-30 


Data 0-7 


Busy | 
Error |= 
GND fF 


Figure 4. Connections to a Centronics port. 


PARTS LIST 


Semiconductors 
IC1, IC2 

IC3, IC4 

IC5, IC6, IC7 

IC8 

Ico 

1C10 

D1-6 : 
D7 Min red LED 


6116 
74LS241 
74LS157 

4040 BE 
74LS04 
74LS32 


Resistors 

R1 1K 
R2 100R 
R3 4K7 
R4 10K 


R5 1K Bee 
R6 1K foe 


R7 330R | 
R8 1K 


Capacitors 
100uF 16v Radial Electrolytic 
10uF 16v Tantalum 
10nF Disc ceramic 
100nF Disc ceramic 


Miscellaneous 

PCB; Twelve IC sockets: 3 x 24-pin, 2 x 14- 
pin, 2 x 20-pin, 5 x 16-pin; 3.6v NiCad 
battery (Ambit); Two sub-min SPST 
switches; Ribbon jumper-cables: 16-way 
single ended DIL header, 24-way double 
ended DIL headers (Watford); Veropins for 
LK1-3. 
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All about 


bubbles 


Bubble memory is an exciting new 
technology which will soon be cheap enough 
for use in home computers. William Owen 
explains how it works. 


Bubble memory is the most compact form 
of non-volatile memory available; it has a 
low power consumption and very fast 
access time, a large memory capacity and, 
unlike disc and tape, doesn’t suffer from 
head crash. Bubble is also extremely rug- 
ged, operating efficiently in the harshest of 
environments, and in cartridge form — the 
most common available — it is exchange- 
able and portable. So why isn't everybody 
using it? 

Bubble memory is the great white hope 
(and the great misnomer) of the computer 
world. For at least five years the pundits 
have predicted that bubble will be the next 
big thing: each year the bubble bursts. 
Despite its advantages bubble memory 
has proved too expensive for all but the 
most specialised — usually military — appli- 
cations. Companies of the stature of IBM, 
Texas Instruments, Plessey, NatSemi and 
NEC have despaired of making the neces- 
sary technological breakthrough and 
halted research projects. 

However, there are now indications that 
bubble memory is about to find an estab- 
lished place for itself, particularly in port- 
able and small micros. For the moment 
bubble is still too expensive for all home 
and most personal computers, but it is 


possible, if not probable, that in future the 
disk drive will be replaced by the bubble 
cartridge interface. 

But bubble memory has very little to do 


Figure 1. The way in which the bubble memory 
moves through the chevrons. 


TABLE 1 Comparison of characteristics of disk, tape and bubble (source, Immediate Business 


Systems). 


MEAN OPERATING 
STORAGE ACCESS ERROR MTBF LIFE OF TEMP 
DEVICE TIME (ms) RATE (YEARS) ELEMENT RANGE°C 
HARD DISK 30-75 101° 2 5 YEARS +5—+45 
FLOPPY 
DISK ne 1%2 10_9 1 0-500h  +5-+45 
START/STOP 
TAPE TIME ; 
CASSETTE 20ms plus {or 1 50-500h +5—+45 
SEEK TIME 
BUBBLE 12-5 tor >40 >40 YEARS -—30—+70 
LIMITED 
ONLY 
BUBBLE 12-5 to-= 40 20,000 O—+50 
CASSETTE INSERTION 
REMOVAL 
CYCLES 
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with bubbles: the ‘bubbles’ are tiny circu- 
lar magnetic domains within an epitaxial 
film layer on the chip. The domains are 
made to move through the medium by an 
external magnetic field — they are polarised 
in the reverse direction to the medium. 

Modern magnetic bubble memories 
(MBMs) are constructed from a thin layer of 
garnet, deposited as epitaxial film on a 
substrate of simpler garnet. It is within the 
complex layer of garnet that the bubbles 
reside. Above is a layer of insulation, a con- 
ductor, a permalloy and a passivation 
layer. 

The complex garnet has a pattern of 
metal shapes deposited onto its surface. 
The shapes are usually in the form of chev- 
rons, and the bubbles, or magnetic 
domains, move through each chevron and 
can jump between one chevron and 
another under the influence of the mag- 
netic field (see Figure 1). Data is rep- 
resented by either the presence or 
absence of a bubble within a chevron: 
those with a bubble are ones, those with- 
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out are zeros. 

This goes some way to explaining how 
MBM is programmed, but not why it is non- 
volatile. The bubbles are moved through 
the chevrons by a rotating magnetic 
phasor, revolving 100,000 times a second, 
but the bubbles are kept in position when 
the power is switched off by a second, per- 
manent magnet biased at an angle to the 
chip. The bubble chip itself is heavily pro- 
tected from external magnetic fields which 
could affect the data within, while the per- 
manent magnet holds each bubble in the 
place to which it was sent by the rotating 
phasor, whether the power is on or off. 

MBM uses serial architecture, based on 
a number of loops of chevrons. Each loop 
has an input for writing (called a swap gate) 
and an output for reading (a replicate gate). 
Bubbles are generated according to data 
sent from the CPU, and enter the loops via 
THE SWAP GATE. The bubbles are pulled 
out of the loop at the replicate gate (for 
reading) by a small current pulse, and read 
by a bubble detector. 
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Sharp PC-5000 


The Sharp PC-5000 is a 16-bit 8088 portable computer which uses 
128Kbyte bubble memory cartridges as the standard means of data 
storage. The bubble interface acts in the same way as a single sided, 
single density disc drive operating under MS.DOS, sacscparsy bee file trans- 
fer and information exchange betweenMBM cartridges and floppy 
drives. 

Despite its expense (£150 per cartridge) bubble memory was 
chosen for the PC-5000 not only because of Its efficient capacity/size 
ratio, but also because of its extremely low power consumption; this 
allows the PC-5000 to become a truly portable computer in that it is 
in no way reliant on mains power supplies. 

The bubble memory adapter is interfaced with the host system 
via 8 bits of parallel data, and performs various types of controls and 
transfers of data through the register in the bubble memory control- 
jer. 

The bubble device is a Hitachi version, which employs a major 
line and minor loop system, comprising two 512 Kbit blocks. Each 
block has 228 minor loops, which are data storage areas. Each loop 
has a storage capacity of 2335 bits. Of the 288 minor loops in each 
biock, 256 are usable for actual data storage, one loop for parity data, 
and one loop as a marker for storing reference markers for page 
addresses. The remaining 30 loops are redundant, and used to 
replace any defective minor loop; this is common practice in bubble 
memory manufacture, and cuts the component failure rate by a con- 
siderable amount. 


The GRiD Compass 


While the Sharp PC-5000 may be just beyond the price bracket of the 
average home computer enthusiast (£1195) the GRID. Compass is 
bist! over the horizon: prices start at £5195. 

The GRID is very much the computer of the future. It has 384 
Kbytes of bubble memory and 256 Kbytes RAM. There are two central 
processors, the true 16-bit Intel 8086, and the 8087 high speed 
maths processor. The machine includes an inbulilt modem, IEEE 48s 
and RS232-C interfaces, battery powered real-time clock, and flip-up 
electroluminescent flat panel display — all in the space of a very small 
brief case. The single omission is an on-board thermal printer (an 
omission not made by Sharp). The GRID is marketed as ‘the ultimate 
professional computer’. Given two years the ultimate home computer 
may look something like this. 


A typical bubble device can store one 
megabit of data within its loops. Access 
time is very fast because the loops are held 
in parallel series, distributing the data 
between them; that is, a serial stream is 
sent to the bubble generator and then the 


stream of data is deivided up between a 
number of loops. Typically the data rate is 
100Kbits per second, and the access time 
12.5 milliseconds. 

Magnetic bubble emory compares 
favourably in terms of speed with magnetic 


TABLE 2 Comparison of solid state memories (source, Immediate Business Systems). 


ERASABLE EFFICIENT EFFICIENT 


NON FREQUENT IN BIT BYTE 

MEMORY VOLATILE WRITES ERASABLE SYSTEM TRANSFER TRANSFER 
SRAM oo 3 roa @ 
DRAM eS r Ea @ 
ROM@® boa 
PROM ea @ 
EPROM «€ 6 s 
PROM * e e ” 
eae * a - * *” 

MBM @ @ a Se bad 
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SWAP GATE : 
INPUT TRACK = 
(MAJOR LOOP) : 


MINOR LOOPS 
s 


Figure 2. Simple bubble memory architecture. 


disk and tape (see Table 1),~with a 
performance and cost per bit intermediate 
between semiconductor memory and disk. 
Only dynamic RAM has a capacity per 
device equivalent to MBM. 

Table 2 compares the characteristics of 
bubble memory and other solid state 
devices, and it can be seen that only bat- 


September 1983 

BBC Darkroom Timer 
October 1983 

Spectrum Effects Box 
Cassette Signal Conditioner 
BBC EPROM Programmer 


November 1983 


December 1983 

BBC Sideways RAM 
Electron A/D 

January 1984 

Electron I/O Port 

February 1984 

BBC Speech Synthesiser 
Electron RS432 

Spectrum Speech Board 
BBC Sideways ROM Board 
March 1984 

Spectrum Cassette Controller 


April 1984 
Commodore A/D 


Spectrum Diary 
Centronics Buffer 


June 1984 
Mains Data Link (2 Boards) 


BUBBLE DETECTOR 


t > 
aa LOOP IN ))> 
REP GATE 


OUTPUT TRACK 
(MAJOR LOOP) 


tery backed (non-volatile) RAM comes 
anywhere close to the flexibility of MBM. 
The development of MBM has, to a 
degree, parallelled semiconductor 
technology in that it was dependent upon 
the associated recution of film thickness 
and improvement in integration techniques 
to make it a viable proposition. Bubble 


memory was invented in 1967 by Bobeck, 
of Bell Telephone Laboratories in the USA, 
but similar technologies involving thin film 
plated wire were being investigated in the 
fifties at Bell and Hughes Research. Full 
commercial production did not begin until 
1979 (at Fujitsu), but already 256K devices 
were being produced (by Fujitsu, then 
Texas Instruments and Rockwell). Today 
the average size of MBM devices is 1MBit, 
and large quantities are produced by Bell, 
Intel, Motorola, Hitachi, Fujitsu) and 
Sagem. Hitachi and Fujitsu alone manu- 
facture over 25,000 1Mbit devices per 
month. 

A number of factors have contributed to 
the upsurge in MBM production. Not least 
the reduction in manufacturing costs to a 
level acceptable to certain key growth 
areas: communications and portable com- 
puters. 

The communications industry requires 
high speed, portability and reliability and 
the advantages of bubble in portable com- 
puters are obvious: compact size and ease 
of use. 

Other applications have been found in 
avionics, control equipment, data loggers, 
office automation, portable instrumenta- 
tion and shipborne instruments. But port- 
able PCs are by far the most interesting 
area, and you will find details of two very 
recent products which point the way to the 
future on the previous page; the Sharp 
PC5000 and Grid Compass. 


July 1984 


(R Data Link (2 Boards) 


August 1984 


October 1984 


EPROM Simulator 


Robot Wall Builder 


September 1984 
Spectrum Frequency Meter 


HOW TO ORDER 

List the boards required and add 45p post and packing 
charge to the total cost of the boards. Send your order with 
a cheque or postal order to: 


E&CM PCB Service, Scriptor Court, 
155 Farringdon Road, London EC1R 3AD 
Telephone: 01-837 6255 


Please supply the following PCBs: 


Post & Packing 45p 


TOTAL E£ 


PLEASE ALLOW 28 DAYS FOR DELIVERY 
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> INTERFACING 
i TECHNIQUES - 
THE OPERATION OF © 
SHIFT REGISTERS 


| This month, Paul Beverley describes the basic operation of shift 
registers and illustrates their use in a variety of applications. 


Ashift register is an electronic circuit capa- 
ble of storing a binary number, but which 
also is capable ' of being shifted ie the 
number can be moved sideways, being 
pushed along one bit each time it receives 
a clock pulse. By shifting sideways, the 
data can be entered or sent out serially. 

When shift registeres are supplied as 
individual chips they come in a whole 
variety of configurations depending on the 
different ways in which they can be written 
to and read from. They must at least have 
some sort of serial input or output, or there 
would not be much point in calling them 
shift registers, yet some of them such as 
the 74LS91 only have serial input and out- 
put with no parallel access at all. Others 
allow you to write into them in parallel on 
eight data lines and then shift out serially 
(PISO — parallel in, serial out), and others 
allow numbers to be shifted in and then 
read out in parallel using the eight data 
lines. {SIPO — serial in, parallel out). 
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The main limitation on these single chip | chip. If you want parallel input as well as 
shift registers is the number of pins on the | parallel output then you have to have 16 


Figure 1, The modes of operation of the VIA shift register as controlled by bits 2, 3 and 4 of the 
auxilliary control register (&FE6B on the BBC microcomputer). 
seer ot — - TET: 


oA 


LISTING 1 — Outputting choracters, typed in 
at the keyboard, from the VIA shift register. 


lines for the parallel data even before think- 
ing about serial lines, control lines or power 
supply. The 6522, however, already has 
parallel input and output on the normal 
6502 data bus. Thus all it needs is a serial 
in/out line and a control line. This facility 
amongst others is provided by the CB1 
and CB2 control lines. The VIA’s shift regis- 
ter can then have numbers fed in and taken 
out in parallel as well as in serial form. 
(PIPOSISO!) The parallel data is accessed 
through register 10 of the VIA (&FE6A on 
the BBC microcomputer) and control of the 
modes of operation of the shift register is 
achieved through the auxilliary control 
register (register 11 — &FE6B on the BBC 
microcomputer). 

Whether the data is being shifted in or 
out, CB2 is used to carry the data. This 
means that the same physical line may be 
used for output as well as for input, which 
is exactly the same as the way that each 
individual port line can be used for either 
input or output. Care has to be taken, 
therefore, in programming the shift register 
because if you are trying to shift data in, 
and have CB2 connected to a source of 
signals, you might accidentally set CB2 
into an output mode. This might well dam- 
age one of the ICs either the 6522 itself or 
the chip which is driving signals into it. 

The same is true of the CB1 line which is 
used to carry the clock signals which con- 
trol the shifting of data into or out of the 
shift register. The problem here is probably 
more serious than with CB2 as it is easier to 
confuse the different modes and end up 
with CB1 acting as an output when you 
intended to feed clock pulses into the VIA. 


Mode selection 


The mode of operation of the shift register 
is controlled by bits 4, 3 and 2 of the auxil- 
liary control register (register 11, &FE6B on 
the BBC microcomputer). Bits 7, 6 and 5 of 
this register, which we dealt with in a pre- 
vious article in this series, control the 


modes of operation of the two timers. Bits 
1 and 0, which control the latching of data 
into the two ports, will be referred to in a 
later article. Figure 1 shows in tabular form 
how the different modes are controlled, 
and as you can see, bit 4 is what might be 
referred to as the data direction bit. As with 
the individual bits in the data direction 
registers for the two ports, logic 1 sets CB2 
as an output, and logic 0 sets it as an input. 

There are three basic ways of clocking 
the data, as set by bits 3 and 2, for each of 
the states of bit 4. “01” selects timer 2 as 
the source of clock pulses, “10” selects the 
system clock, and “11” allows you to apply 
an external clock pulse to CB1. 

In the 01 mode, the low byte of timer 2 is 
used by the VIA to time the clocking of the 
shift register. If the number in the timer 2 
low order latch is N, then the register is 
shifted once every 2 * (N + 2) clock cycles. 
This allows a time of between 4 micro- 
seconds per bit and 514 microseconds per 


“Data can be loaded into 
the VIA shift register on 
one machine and shifted 
along a single 
communicator channel to 
a second VIA which shifts 
the datain”. . 


bit, assuming a 1MHz clock rate since N 
can have values between 0 and 255. To set 
up this mode, all you have to dois to set the 
relevant bits of the ACR and put the delay 
time value into the timer 2 low latch (&FE68 
on the BBC microcomputer). 

In the 10 mode the register is shifted 
once every other cycle of the system clock 
ie once every two microseconds, and in 
both of these modes, CB1 acts as an out- 
put, producing a pulse which can be used 
to clock an external shift register whose 
data line is attached to CB2, CB1 being 
inverted every system clock pulse. The 
actual shifting takes place on the positive- 
going edge of the CB1 clock pulse. 

The 11 mode allows a pulse to be fed 
from an external source into CB1 to control 
the shifting at any speed you wish. You 
could, for example, generate a suitable 
pulse train by setting timer 1 into the free- 
running mode and taking an output from 
PB7. As with the other two modes, clock- 
ing takes place on the positive-going edge 
of the clock pulse applied to CB1. 

Of the two modes not so far mentioned, 
000 is the simpler. It totally disables the 


FEATURE 


shift register and allows the CB1 and CB2 
lines to be under the control of the 
peripheral control register for use in the 
handshaking of parallel data transfer. The 
100 mode on the other hand is an active 
mode. Since bit 4 is set, it is an output 
mode, and what actually happens is that 
any number loaded into the shift register is 
outputted serially on CB2 under the control 
of timer 2 as in the 101 mode, but it is out- 
putted repeatedly. What happens inside 
the VIA is that the serial output of the shift 
register is fed into its serial input so that the 
number just cycles round and round and 
the data comes out repeatedly. | cannot 
think of any applications for this myself. 
Anyone got any ideas? 

However, to try this mode out, a buffered 
loudspeaker could be attached on the CB2 
line and the following program executed: 


?&FE6B=&10 

REPEAT ?&FE6A = RND 
2&FE68 = RND 

UNTIL O 


This will produce digital noise by changing 
the number being outputted and also the 
rate at which it is being clocked. 


Flags and Interrupts 


Bit 2 of the interrupt flag register (register 
13 — &FE6D) acts as a flag, to signal the 
completion of 8 shifts, either in or out. Your 
program can therefore wait until the shift- 
ing is complete before reading the shift 
register. This flag is set whenever eight 
shifts have taken place whether the clock 
is internally or externally generated. 

Alternatively, this flag can be used to 
generate an interrupt, providing it has been 
enabled by using the interrupt enable 
register (register 14). To enable an interrupt 
on completion of 8 shifts, you simply load 
&84 (10000100 in binary) into the IER. 
(7&FE6E = &84 on the BBC micro- 
computer.) Bit 7 has to be set, to indicate 
that you want to enable the interrupt and 
bit 2 is set to indicate which interrupt is to 
be enabled. To disable it again, you put 
&04 into the interrupt enable register. 


e e 

Applications 

All that has been said so far could have 
been gleaned directly from the 6522 data 
sheets, even if they do make rather heavy 
reading. What is probably more helpful is 
to give a couple of applications so that you 
can see how the shift register can be used 
in practice. As in previous articles, we will 
be dealing specifically with the BBC micro- 
computer, but similar programs could be 
written for other 6502 based micro- 
computers. 


Serial communication 


It is possible to use the VIA shift register for 
serial communication of data. In other 
words, data can be loaded into the VIA shift 
register on one machine and shifted out 
along a single communication channel, 
such as a wire, toa second VIA which shifts 
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the data in. The clock signal from the send- 
ing microcomputer also has to be trans- 
mitted in order to synchronise the clocking 
of the data into the shift register at the other 
end. 

Programs 1, 2 and 3 enable you to try 
this out. The CB1 lines of the VIA’s on the 
two microcomputers have to be linked 
together, as do the CB2 lines, and there 
must of course be an earth return ie you 
must link together the 0 volt lines of the 
User Port connectors of the two micro- 
computers. The sending program, (pro- 
gram 1) is loaded into one computer and 
the receiving program (either program 2 or 
program 3) into the other. The sending pro- 
gram sets the shift register into mode 101 
{at line 10, &14 = 00010100 in binary) to 
put it into the send mode, controlled by 
timer 2. The time delay value is set in time 
2 low latch (line 20) and it then picks up 
characters from the keyboard (line 40) and 
outputs them by putting them into the shift 
register (register 10, &FE6A on the BBC 
microcomputer, line 60) which initiates the 
shifting process. The program then waits 
until the VIA interrupt flag is set, indicating 
that the shifting process is complete (line 
70) before getting the next character. 

At the receiving end, the VIA shift regis- 
ter is put into the 011 mode ie shifting is 


LISTING 2 — Receiving and displaying charac- 
ters coming in serially through the VIA shift 
register, but excluding control codes. 


?2&FE6B = &C 
20 DUMMY = &FE6A 
30 REPEAT 


40 REPEAT UNTIL (?&FE6D AND 4) 
50 X% + ?7&FE6A 

60 IF X% > 31 PRINT CHR$(X%); 
70 IF X% = 13 PRINT 

80 UNTILO 

END 


under contro! of an external clock. This 
clock pulse, of course, comes from the 
CB1 line of the sending microcomputer. 
Listing 2, written entirely in BASIC, waits 
until the shift register flag is set, to indicate 
the completion of an 8 bit shift (line 40) 
before reading the shift register (line 50). If 
the code received is not a control code, 
then it is printed, but if it is a carriage return, 
a new line is generated. The reason for 
doing this is that if an erroneous code is 
received which happens to be a control 
code, it could produce all sorts of undesir- 
able effects. Line 20 also needs explana- 
tion — unless a read is done, the shifting 
process does not start, therefore we do a 
dummy read in order to get things going. 
Listing 3 is a machine code version of 
listing 2 which was tried because certain 


LISTING 3 — Machine code version of program 
2 except that all codes that are received are 
sent to the operating system VDU routines 
whether they are control codes or not. 


?&FE6B = &C 
20 P% = &C00 


[ 

-START 
50 LDA&FE6A 
60 LDA #4 


Dummy read 


80 .WAIT Wait for 
90 BIT&FE6D shift register flag 
100 BEQWAIT to be set. 


LDA &FE6A 
JSR &FFEE 


Get character. 
Output to screen. 


JMP START 
] 


CALL START 


Do it again. 
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problems occurred with Listing 2. Charac- 
ters were being incorrectly received, and 
this appeared to be caused by the loss of 
synchronisation of the signal. Using 
machine code will obviously increase the 
speed of response to in-coming signals, 
but it did not in fact reduce the frequency of 
errors. Even at the slowest speed, as set by 
timer 2, there were still errors. The most 
likely cause of this problem is the degrada- 
tion of the waveform caused by the capaci- 
tance of the wires carrying the signals. 
According to the 6522 data sheets the 
timing of the clocking of the shift register 
should be such that tlie delay between the 
positive-going edge of the clock pulse and 
the next negative-going edge of the 
system clock should be between 0.3 and 
1.0 microseconds. Thus the capacitive 
loading on the line may well increase the 
delay sufficiently to cause the clocking to 
be a bit marginal. 

In the experimental set-up there were 
ribbon cables at both ends going into 
ready-made interface boxes with 4mm 
sockets. The CB1 and CB2 lines were then 
linked by 4mm plug leads. When these 
were replaced by two ribbon cable jumper 
leads wired together directly, the error rate 
decreased, but communication was still 
not error-free. This supports the view that 
the errors are a result of the degradation of 
the waveform. 

The solution would be to use a line driver 
IC as close to the sending VIA as possible. 
However, this was not actually tried out as, 
on the BBC microcomputer at least, this 
application is little more than an academic 
exercise. The BBC microcomputer has 
RS423 serial communication hardware 
with excellent, interrupt driven software in 
its operating system which enables it to 
operate in send and receive modes simul- 
taneously. 


Hardware Random 
Number Generator 


One application to mention here is that of 
using the VIA to read in the data from a 
hardware random number generator. The 
random number generator in BBC BASIC 
is implemented in software using a 
machine code routine which is the 
analogue of an electronic circuit known as 
a ring counter which is basically a shift 
register (33 bits long!) with some exclusive- 
OR feedback. if this ring counter were 
implemented in hardware it could be read, 
as in the previous application, by using the 
VIA shift register. 


Next month 


A much more useful project for the BBC 
microcomputer owner who is interested in 
electronics is that of making a logic state 
monitor. This is a rather grand name for a 
simple device that reads the logic states of 
the number of lines and in some way dis- 
plays them. Next month we will look at a 
way of doing this with the BBC micro- 
computer. 
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Extending QL 
SuperBasic 


Although the QL’s SuperBasic is in many 
respects a wonderful programming 
language it is somewhat deficient when 
seen as the QDOS command language. 
Where are essential disc commands like 
BACKUP and RENAME? 

Luckily the mechanism for extending the 
procedure list is simple —in Basic! The pro- 
cedures to do these extra operations are 
also generally easier to write in Basic, so 
that’s what we’re going to do here. 

The author is currently working on the 
machine code versions of these pro- 
cedures so that these can be linked in as 
part of the ‘permanent’ procedure/function 
list on boot. The QDOS documentation 
explains reasonably clearly how to do this, 
but the lack of a QL assembler makes 
things rather awkward at the moment. 

When adding procedures and functions 
to SuperBasic from within SuperBasic, 
one has to choose a line numbering such 
that as little conflict as possible occurs 
with the user’s own program and the 
easiest way to do this is by using the 
highest line numbers possible. The list of 
procedures described here starts at line 
31500, and with the default AUTO line 
number of 100 it would take a very exten- 


sive program indeed to overrun the pro- 
cedures. Naturally those procedures that 
are not required within a particular applica- 
tion may be deleted if the program does 
get too big, but if you do this you must 
ensure that procedures that are called by 
other procedures are not deleted. 

As a number of QL owners are likely to 
be new to Basic programming it is as well 
to get the distinction between procedures 


. - the mechanism for 
extension is simple”. 


and functions clear at the start. In many 
respects they are the same in that they are 
both defined blocks of code that perform a 
particular operation or sequence of opera- 
tions. 

The fundamental difference is that a 
function returns a result while a procedure 
does not. This issue can become a little 
clouded when a procedure is written which 
alters the value of a variable declared out- 
side the procedure, as it then appears to 
return a result, but in such cases the result 
is implicit rather than explicit. 
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To clarify this, it makes sense to assigna 
variable to a function, but a similar opera- 
tion within a procedure would be syntactic 
nonsense. In other words if func(param) is 
a function then one can write 


result = func(param) 


but if it were a procedure one could not. As 
an example, let’s consider some Super- 
Basic functions and procedures. SIN, INT, 
RESPR and CHR$ are examples of func- 
tions as all the lines below make perfect 
sense: 


PRINT SIN(PI) 

x=INT(RAD)(45)) 

space=RESPR(1024) 

a$=FILL$(CHR$(26),34) 
SuperBasic procedures are things like 
CLS, PRINT, LIST and POKE. That's 
because you can say things like: 

PRINT “I’m a procedure” 
while things like 

a=CLS 
are pure rubbish! Notice how SuperBasic 
functions, whether inbuilt or user defined, 
always have their parameters in brackets 
while procedures in general don’t. We say 
‘in general’ because it is quite valid to 
include parameters in brackets, but doing 
so alters the way they are treated by 
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SuperBasic. A parameter of x is subtly 
different to a parameter of (x) — the first 
case results in the variable itself being the 
parameter while parenthesised parameters 
pass the value. 

This is only of significance to us when a 
procedure alters a global variable — by pas- 
sing the variable in brackets it won’t get 
altered. Sometimes! 

While we're defining things we might as 
well make the distinction between 
operators and procedures/functions too. 
An operator returns a result by operating 
on one or more operands, so that in an 
operator that returns the negative of the 
operand following it, and + returns the 
result of adding the operands on either 
side of it and MOD produces the remainder 
of an integer division of the left hand 
operand by the righthand operand. Notice 
that, unlike most other computers that 
supply this function, INSTR in SuperBasic 
is an operator and not a function. 

Now onto our defined procedures and 
functions. Notice that in many cases we 
have declared certain of the parameters as 
being typed (ie said that they are integer, 
string or whatever) despite the fact that for- 
mal parameters are defined as typeless in 
SuperBasic. This has been done simply to 
clarify the use of each parameter and it is 
not necessary to adhere to this nomencla- 
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2) channel (1) but it is a simple matter to alter 


ture. Listing 1 is a procedure to spin a 
specified microdrive cartridge until the 
ESCAPE key is pressed. Although this may 
at first sound entirely fatuous it has proved 
to be of immense value when trying to 
recover data from microdrive cartridges 
that seem intent on always returning bad 
or changed medium error reports. It will 
by no means always recover a set of data 
but a good spin of sixty seconds or so does 
seem to do a cartridge wonders! The pro- 
cedure also raises a few interesting points 
about SuperBasic. 


“SuperBasic is somewhat deficient when seen as the 
QDOS command language”. 


As with other procedures it is good pro- 
gramming practice to reduce the scope of 
variables within a procedure as much as 
possible —in other words, make them local 
as the first line of a procedure or function 
definition. This has been extended to 
include loop identifiers (used in REPeat, 
FOR and SELect) because the scope of 
these matches are that of a variable. 

The SPIN procedure first builds up a 
string to represent the specified microdrive 
cartridge, putting the result in drive$. It 
then opens the smallest screen window 
possible to channel 200. Such a high chan- 
nel number was chosen simply because it 


| type CAT nto catalogue a drive rather than 


4 ing the channel to catalogue to. 


FEATURE 


is unlikely to conflict with channel defini- 
tions elsewhere in a program. This line also 
shows up to points worth noting. Firstly, 
although the QL User guide implies that 
window definitions can use steps of 1 pixel 
this in fact seems to be 2 pixels in reality. 
Secondly the guide again implies that only 
channel numbers #0 to #15 are valid in 
Basic (as is the case with the Spectrum). 
This also turns out to be untrue, although 
we have yet to discover the highest chan- 
nel number that is available. 

Once this window is open we enter a 
loop in which the cartridge is repeatedly 
DIRd to this channel until the ESCAPE key 
is pressed. As the window is so small and 
out of the way it is, to all intents and pur- 
poses, invisible. Once ESCAPE has been 
pressed we clear and close channel 200 
and then return to whatever called the pro- 
cedure. Believe me, it really isn’t as facile 
as it seems! 

The procedure of Listing 2 is short and 
sweet and merely serves to increase the 
friendliness of SuperBasic. It allows us to 


having to go through the eventually rather 
tedious process of having to type DIR 
mdvn_ each time. As the procedure 
stands it can only catalogue to the default 


it to accept a second parameter represent- 


The procedure is straightforward and 
self explanatory. 


at’s in a name 


Listing 3 shows a procedure that is of 
rather more immediate use and simply 
adds ‘a RENAME procedure to Super- 
Basic. It has three parameters — the file 
name to be renamed, the new file name 
and the drive. As it stands the procedure 
will not allow you to generate a copy of a 
file on a different drive, which is standard 
RENAME practice. If you really want to do 
this, try the QL’s COPY procedure! 
RENAME works by building up two strings 
— one to define the old file and one to define 
the new file. The old file is then copied to 
the new file and subsequently deleted, 
which is the nearest we can get to a 


RENAME. Certainly its effect is to rename a 
file, but if the file to be renamed is longer 
than the space left on a cartridge it 
obviously can’t do its job. It would proba- 
bly be possible to write a machine code 
procedure to rename every sector of a file, 
but it would be of dubious value as it would 
decrease the life of the cartridge, which is 
short enough now! 

Note that there is no explicit error check- 
ing within the procedure, so if the old file 
does not exist or the new file does already 
exist, a standard SuperBasic error mes- 
sage will be generated and the procedure 
will be aborted. For this reason error 
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checking was deemed unnecessary. 

The most complicated procedure is that 
which performs a drive-to-drive backup. It 
uses a fairly devious technique to discover 
which files exist on the source drive's car- 
tridge, and it includes the option to delete 
the original files as it goes. This option 
would be taken if a cartridge were proving 
unreliable and you wanted to reformat it 
but keep the files it contains intact. This 
option is selected by making the third 
parameter anything other than zero. A 
value of zero for switch™% forces the pro- 
cedure to perform the more usual backup 
facility tr which files are simply copied 
across. This procedure is shown in Listing 
4. 

The first thing this program does is 
define three strings — d$, a$ and b$. The 
first holds the filename ‘dir_tmp’ on the 
destination drive, the second holds the 
source drive definition and the last holds 
the destination drive definition. Channel 3 
(you may alter this of course) is then 
opened as anew file and the source drive is 
catalogued to it. This file is then closed and 
re-opened for read only. Two dummy 
strings are then input from the directory, 
the first representing the cartridge name 
(which we don’t need) and the second rep- 
resenting the number of sectors available 
on the cartridge. Again, we do not need this 
information, Everything left in the file is 
then a file name to be copied across, so we 
enter a REPeat loop (controlled by 
movefiles) to copy each file. The first thing 
this loop does is check to see whether we 
have reached the end of the directory file, 
and if so leave the file. The end of the file is 
checked first because if we attempted to 
backup an empty drive this occurrence 
would be trapped without error before it 
happened. In other words the loop is set up 
to act as a zero-case trap loop, something 
which is tedious to implement on a BBC 
Micro! 
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= de avese md Sd 
3 OFENWCHL, sero 
5 REFeat loop 
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BACKUP then prints a message to chan- 
nel zero (the command channel) telling us 
which file it is copying, and then it copies 
that file from source drive to destination 
drive. Finally, if switch% was given a non- 
zero value then it will be considered as 
TRUE, so the source drive file just copied 
will be deleted. If the parameter was zero 
then no files will be erased. Once the end of 
the directory file has been reached the loop 
is ended and channel 3 closed. The direc- 
tory file is then deleted and the procedure 
ends. Again there is no explicit error check- 
ing, aS common sense and SuperBasic 
ought to prevail! 


Classic coding 


The next piece of code is a classic con- 
version function that returns a decimal 
number corresponding to a string para- 
meter that is taken to represent a number in 
any base between 2 and 36. It works by 
zeroing an accumulator (the variable total} 
and progressively adding each converted 
digit to base times the accumulator. The 
method is not the fastest but it is the 
easiest to understand. It makes use of the 
QL's INSTR operator to find the position of 
each digit in a string comprising all possi- 
ble digits for that base, and returning its 
representative decimal value to the vari- 
able temp. If the tested digit does not 
occur in the string then it is treated as 
invalid and results in temp having a value 
of —1. 

Once the value has been obtained 
invalid digits are trapped in such a way that 
the function terminates immediately and 
returns a value of zero. In valid cases the 
process is repeated for the length of the 
number string. Listing 5 shows the proce- 
dure. 

The reverse of this function is provided 
by the next function OFDEC$. This is pas- 
sed as a decimal number and a number 
between 2 and 36 to represent the base. 
The decimal number is then converted to a 
string representing that number in the 
given base, and this is returned as the 
function's result. It works by using a pro- 
cess analogous to splitting a number up 
into the number of units, tens, hundreds, 
thousands and so on that form the number, 
but instead of splitting it into powers of ten 
it splits it into powers of the specified base. 
The resulting number is then converted to 
ASCII and added to the front of an initially 
null accumulator string (unfortunately cal- 
led hex$ here!). The end effect is to pro- 
duce a string that accurately represents 
the number. OFDE$ is shown Listing 6 

Numbers to the base 16 (hexadecimal or 
just hex) are so useful in computing that a 
function to allow us to use hex numbers 
within a SuperBasic program would be 
very useful. Our DFC function would do 
this quite happily but it always has to be 
passed two parameters the nex number 
and 16 to represent the base. So this short 
function, called HEX, calls up DEC and 
automatically adds the base as 16 during 
the call. This means that we can now use 
hex numbers very easily, like so: 
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POKE_W HEX (‘20000’), HEX(‘4E75’) 


Our final manipulation of the two base 
conversion functions results in a routine 
that will convert a number in one base to a 
number in another base. We use one of our 
functions as a parameter to the other, 
resulting in a base to base conversion 
involving decimal as an intermediate stage. 
This is by far the easiest method, and the 
function thus defined is known as BASES. 
It is passed by three parameters — the 
number to be converted (passed as a 
string) and the two bases. The first is the 
base that we are converting from and the 
second is the base to which we want to 
convert. This procedure is shown in List- 
ing 8. 

The final procedure shown in Listing 9 is 
purely of interest to those with an Epson 
dot matrix printer. It opens a specified 
channel to the printer (which is assumed to 
be connected to serial port one) and then 
prompts for an option string. This option 
string can consist of any combination of 
the digits 0, 1 and 2. Option 0 initialises the 
printer by sending ESC (@, option 1 sets 
the UK character set (so that £ signs get 
printed properly) and option 2 sets up the 
USA character set (so that the # sign gets 
printed correctly). 

This set of nine procedures and func- 
tions merely serves to demonstrate the 
power of SuperBasic, and the user can 
easily write a whole bunch more for all 
sorts of applications. 


31920 DEFine FuNetion DECinum®, base) 
31930 LOfal totel,temp,loop 

31940 total =0 

31951! FOR loop=i TO LEN mums? 


4 Fa 


temp={num#iloop! INSTR “O145456789ABCD 
EFGHIJELMNOPERSTUVWEYZ"() TO base? 
bel 
21970 
31980 
31996 


IF temps *=1 

total stotal base ttemp 
ELSE 

total =o 


EXIT boop 
END IF 

END FOR loop 

Return total 

END DEFine 


DEFine FuNction OFDEC#inumber,base? 
LOCal num,ti,t2,nex#,burtdatring 
Tum sriLimbp apr 3 tag =“ 
REPeat buridstring 
IF numébase:EXIT buildstring 
tISINTinum/base}stZet1 
tl*num-ti*bagernumst2 
hex S=CHRS (t44+48+748 (C159) }&hexs 
END REPeat buildstring 
hex S=CHRSE (mums 4+ Pe (uM Ph nes 
32160 RETurn hex# 
22170 END DEFing 


321B0 DEFine FuNction HEX then? 
RETurn DEC thex#,16) 
290 END DEFine 


110 DEFine Function BASES (num#,basel,basez) 
RETurn OFDECE (DEC (nuns base) basezi 

30 END DEFine 

DEFi ke FROCedure EPSON (ehan®) 

LOCal uk#,usa#,init#,chorce#,ch,]oop 
uk=CHRF( 27) R'LCHRHUS) rusafeuks 
OPEN#chan%, seric 


270 


ft TO 2: SCHR#Et0) init eMCHREI ZF @ 
32280 REPeat lenp: INPUT#O; “Initialine 
(>, Set UK 41) of Set SA (2)7 'choireF: I 


F choices<s°’1Exif loop 
FOR }oop=1 TO LENichoice#) 
ch=choice® loop) 
SELect ON ch 
“a 
PRINT@chank%pinat #t 
=1 
PRINT#chank suk dy 
PRINT#chanksusa¥ts 
=REMAINDER 
PRINT #0; invalid gerameter "* 
fiG END S€Lect 
10 END FOR loop 
20) PRINT#O; "Printer channel ‘ 
52430 END DEFine 


ipnop!*! 


‘chant! ‘ow set up’ 


OCTOBER 1984 


AMSTRAD CPC 464 FACT SHEET 


In the first of a new series, Robert Penfold collects together 
information of a variety of computer. He begins with the new 
Amstrad Computer 


Although the CPC464 is 
powered from a non-optional 
monitor, the use of separate 
monitor and power connectors 
enables, for example, the 
colour monitor to be used as 
the power source and a high 
definition monochrome monitor 
to be used for wordprocessing 
in the 80 column mode. The 


me 
cee 


a provision for two fire-buttons 
per joystick. The joysticks can 
be read from BASIC using the 
JOY function. Details of the 
joystick port connections are 
also included in Figure 1. 


Expansion port 


The main port for user add-ons 


ees es eee 
ene, 


Mn te & pat phe? 
Figure 1. Details of the joystick and monitor connectors. 


monitor socket is a standard 6 
pin DIN RGB type (see Figure 
1). 

The joystick port is a 
pseudo-Atari type, and a similar 
joystick can be plugged direct 
into this 9-way D plug. It also 
has the ability to take a second 
joystick (which will plug into the 
first if the proper Amstrad types 
are used). The second joystick 
uses the same “direction” 
inputs as the first but it has a 
separate “common” 
connection. No games paddle 
inputs are included, but there is 


ee 


Figure 2. The “floppy disc” port 


46 - ELECTRONICS & COMPUTING MONTHLY 


is the “floppy disc” port. This 
has all the address, data, and 
control bus connections, plus a 
few additional lines including a 
+5 volt output. Connections 
are made to this port by way of 


a 2 by 25-way 0.1 inch matrix 
edge, connector. Full 
connection details of this port 
are shown in Figure 2. In 
non-standard Z80 interfacing 
fashion, all sixteen address 
lines are used for the input/ 
output map. The basic 
technique is to decode only the 
eight most significant address 
lines, but some or all of the 
lower eight address lines can 
also be decoded if more than 
one decoded output is needed. 
Addresses from &F800 to 
&FAFF are free for user 
add-ons, Full address decoding 
of the eight most significant 
address lines is not essential, 
and the basic method 
recommended by Amstrad is to 
have user input/output devices 
activated when A10 and IORQ 
(plus RD or WR) are low. This is 
similar to the method used with 
the Spectrum where A5 and 
IORQ going low are used to 


activate add-on circuits. 
Access add-ons using 
addresses that take the five 
most significant address lines 
high (eg addresses from 
—F800 to &F8FF) so that 
spurious operations of internal 
circuits are avoided. An 
attractive feature of the 
Amstrad system of interfacing 
in comparison with the 
Spectrum method is that the 
eight least significant address 
lines are not tied up by internal 
circuits and are available for 
add-ons. This conveniently 
enables user add-ons to be 
placed at consecutive 
addresses,.and a large address 
range is available. 


Figure 3. The port connections. 


“SOUND” is an audio input, 
and a signal of about 50mV 
RMS is needed to fully drive the 
amplifier. A lightpen input is 
included, and as the CPC464 
has the same video controller 
as the BBC machine (a 6845) a 
BBC compatible lightpen 
would presumably be suitable 
for the CPC464. The 6845 
address register is at /O 
address &8C00 while the data 
register is at &DOO when 
writing, or &8FOO when reading. 

Input and output devices can 
be accessed from BASIC using 
the normal (for Z80 based 
machines) OUT instruction and 
INP function. From machine. 
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code they must be accessed 
using instructions where the B 
register provides the eight most 
significant bits of the address. 
Block instructions which use 
the P register as a counter 


“The eight least 


significant address 
lines are available 
for add-ons”. 


cannot be used properly with 


the CPC464, 

The clock signal is the 4MHz 
signal used for the Z80A 
microprocessor. 


Printer Port 


Details of the parallel printer 
port are shown in Figure 3, and 
this requires a 2 by 17 way 0.1 
inch matrix edge connector. 
There are only seven data 
outputs since D7 is actually just 
earthed. No “Acknowledge” 
handshake line is provided, and 
the “Busy” line has to be used. 
Data can be written to the port 
at address &EFOO, and the 
outputs latch. Bit 7 is available 
at the Strobe output, but this bit 
is inverted. The Busy line 


r eCTRONICS & 


, COMPUTING 


COMPUTING 


SUBSCRIPTIONS DEPT 
COMPETITION HOUSE 
FARNDON ROAD 
MARKET HARBOROUGH 
LEICESTERSHIRE 


..| Enquiries: Phone 0733 264666 


>» OCTOBER 1984 


Figure 4. The CPC 464 memory map. 


connects to bit 6 of port B of an 
8255 PIA. This can be read at 
I/O address &F500. Obviously 
the printer port could be used 
as a general purpose output 


port with handshaking 
capability if required. 

Astereo audio output is 
available, and this requires a 
3.5mm stereo jack connector. 


Guaranteed... 
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Subscribe! 


The output level seems to be 
too low to drive most amplifiers. 


Memory map 

Figure 4 shows the memory 
map fdr the CPC464, and thisis 
complicated by the fact that the 
Z80 has a 64K address range, 
but the CPC464 had 64K of 
RAM plus 32K of ROM. The 
upper 16K and lower 16K of the 
memory map are shared by 
ROM and RAM; the upper ROM 
is either the built-in BASIC or a 
sideways ROM. The operating 
system is in the lower ROM. The 
firmware should be controlled 
by using the published routines 
and not by altering system 
variables. Many operations 
require several variables to be 
altered. The published routines 
do this automatically and avoid 
the possibility of the machine 
being left in an indeterminate 
and (perhaps) unstable state. 
Routines are called via a jump 
block in RAM. Details of 
addresses plus exit and entry 
conditions are given in the 
firmware manual published by 
Amsoft, which is essential 
reading for the serious CPC464 
programmer. ; 
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DRAGON + FLEX — 
A POWERFUL COMBINATION 


Lee Francis describes the way in which the flex operating system 
interacts with the Dragon 64 computer to provide a powerful 
system suitable for a wide range of applications. 


For the uninitiated, Flex is an operating 
system for 6800 and 6809 based micro- 
computer systems. As such it is of interest 
to owners of Dragon Data’s 64K computer 
and to BBC micro users who invest in one 
of the 6809 second processors that have 
recently been introduced for this machine. 
In this article we shall look at how Compu- 
sense’s version of Flex performs on the 
Dragon computer but the information will 
be of equal relevance to the BBC 
| implementation. 

Flex is supplied ona single 514” disk that 
is accompanied by two manuals. One of 
these is a user's manual detailing the 
facilities provided by the Flex operating 
system while the other is a slimmer volume 
dealing with information that is specific to 
the Dragon implementation of Flex. 


* 

Booting up 

Getting Flex up and running only requires 
that the system disk is placed into drive 1 
(or at least the “first” drive of your system 
which in some cases may be referred to as 
drive 0 in other documentation) and the 
BOOT command entered from the 
keyboard. After a few moments of whirring 
and clicking from the drives, a copyright 
message will be displayed together with 
the invitation to enter the date in the form 
MM,DD,YY - this anglicised version of Flex 
still adopts the American form of day/ 
month specification. 

Having entered the date, the screen will 
give a very brief introduction to Flex in use 
followed by an invitation to see a demon- 
stration program in action. This program 
illustrates the versatile windowing facilities 
built into Flex — these include the means by 
which users may configure their own win- 
dows. 

When Flex is ready to accept a com- 
mand line it will display a prompt that takes 

| the form of +++. As ever the first time your 
master Flex disk reaches this stage the 
important thing to do is to produce a 
backup copy of the disk. To accomplish 
this two of the supplied utilities are called 
into action, The first is NEWDISK (the Flex 
format equivalent). In the Dragon 
implementation this differs from the 


aan Dé ak | L 


standard Flex command in that it offers the 
facility to create disks of a number of 
different formats (single and double 
density, single and double sided). NEW- 
DISK will prompt with the line: 


Standard DRAgon Disk (SSDD 40 track) 
y/n? 


unless there is a good reason this question 
is answered in the affirmative, at which 
stage the formatting process will begin. 
NEWDISK will ask for a name and number 
for the disk, these are not optional and 
must be supplied. 

When formatting is complete the system 
will ask whether or not you wish to format 
further disks. If no further disks are to be 
formatted, the system will respond with the 
familiar +++ prompt. 

The comman to backup a disk is, in a 
refreshingly straightforward —_ fashion, 
BACKUP>; this 


“The main function of any 
operating system is to 
provide a method of 
operating disk files”. __ 


parameters that define the source and 
destination drives. In a twin disk system, 
assuming the master disk is in drive 0 and 
the freshly formatted disk in drive 1, the 
command would be: 


BACKUP 0,1 


The system also makes the provision for | 


single disk operation in which case the 


usual prompts concerning disk swapping a 


are provided. 


Manipulating files 


The main function of any operating system | } 


is to provide an orderly method of manipu- 
lating disk files, and whilst Flex can do 
much more, this is its bread and butter 
function. 

Flex file names consist of three parts, the 
file name, an extension and a drive 
number. The file name is the name 
supplied by the user to describe the file 
while the extension is used by the system 
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is followed by two 


to specify the type of file. The drive number 
is again an obvious specifier but Flex treats 
drives in a subtle way. In a two drive 
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ale of Hotisenies are now 
6809 based processor boards 
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system it is possible to assign one drive to 
be the system drive (this would usually 
hold the system disk) and the other drive to 
be the working drive. (This would hold the 
users disk on which text files or program 
data was being created.) Flex allows these 
drives to be specified by the ASN com- 
mand which takes the form: 


ASN(,W=<drive>) (,S=<drive>) 


Where W and S are the system and work- 
ing drive. In a twin drive system it would be 
usual to assign drive 0 to the system and 
drive 1 to the working drive with the follow- 
ing command: 


ASN,S=0,W=1 


At any stage, issuing the ASN command 
alone will report with the current assign- 
ment of the drives. 

With the above ASN assignment Flex will 
assume that the first filename in a com- 
mand line has the extension .CMD and that 
it is in drive 0. The Flex command 


+++CMD would thus provide a catalogue 
of all files with the .CMD extension on the 
disk in drive 0. The default assignment 
could be over-ridden by including an alter- 
native drive number as part of the com- 
mand line, for example +++CAT,1 would 
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mands as offering similar facilities to the 
CHX and CHD commands. 

Of the numerous facilities that Flex offers 
the COPY command is one of the most 
versatile. This can take one of three forms, 
the first two of which are quite straightfor- 


“Flex is one of the most powerful eight bit operating 
systems — one that has a wealth of applications 
software written for it”. 


provide a list of files on the disk in drive 1. 
The ASN assignment will also mean that 
a command such as LIST MYFILE will list 
the text file named MYFILE from drive 1 
(the working drive) using the LIST.CMD 
utility in drive 0. 
Users of OS9 will recognise these com- 


AML ‘hese products provide an ideal 


is for the development of stand alone 
computer control systems, the power and 


- versatility of the FLEX OS contributing 


it “greatly to reduced development times. 


supply and backplane. 


Compusense also supply a single bones 
6809 computer that is capable of running - 


FLEX. This is a complete computer that 
only requires the addition of disk drives 
(the controller is on board) and a dumb ter- 
minal to form a fully fledged FLEX system 

A 6809 card from Ralph Engineering 
offers Tangerine owners the option of 


upgrading their computer to full FLEX 


Cambridge Micro Systems 
44a Hobson Street 
Cambridge 

CB1 INL 

0223 324141 


Compusense 
286D Green Lanes 
Palmers Green 
London 

N1 35XA 

01-882 0681 


Ralph Allen Engineering 
Forncett End 

Norwich 

Norfolk 

095 389 420 


capability. This card replaces the 6502 


card of the standard system and provides 
a true FLEX system rather than a terminal 
talking to a 6809 card. 
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ward and allow files to be transferred 
between drives, either keeping their origi- 
nal name or having a new name specified 
for the copied version. The third option 
takes the form: 


COPY ,<drive>,<,drive> 
(,<match list>) 
This is the most powerful and versatile 
form of the command as it allows a certain 
group of files (those that match the charac- 
ters given in the match list) to be copied 
between drives. 
Examples of this option would be: 
+++COPY,0,1 
+++COPY,1,0,.CMD,.SYS 
+++COPY,0,1,A,B,CA.T 


The first is equivalent to the BACKUP com- 
mand and would copy all files from drive 0 
to drive 1. The second will copy those files 
on drive 1 with the extensions .CMD and 
.SYS to drive 0, while the third will copy 
those files on drive 0 that start with either A 
or B (regardless of extension) and those 
files that start with CA together with all files 
with the extension .T. 

It can be seen that the Flex COPY com- 
mand is one of the most versatile found in 
any OS and would be a welcome addition 
to the command set of some other well 
known operating systems. 

Flex provides a host of other commands 
that are fully documented in the accompy- 
ing manuals including the CS utility that 
allows one of eight different character sets 
to be selected as well as allowing the user 
to create their own set for special applica- 
tions. 

The above has, it is hoped, given some 
idea of the powerful facilities of the Flex 
operating system. Flex and OS$9 fight it out 
for the affections of the users of 6809- 
based micro systems although many 
would argue that Flex is more suited to 
small microcomputer systems than is OS9. 
This is by virtue of the fact that Flex makes 
no attempt to offer the multi-tasking and 
multi-user options of OS9. While these are 
desirable features in larger systems, they 
are, it is argued, unused complexities on 
systems such as the Dragon. 

In choosing Flex as an operating system, 
the user will have at their disposal one of 
the most powerful eight bit operating 
systems and one that has a wealth of appli- 
cations software written for it — all available 
off the shelf, now. 
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SPECTRUM WORD 
PROCESSOR 


Alan D. Went describes a versatile text 
processor for the Spectrum computer. 


ZX Words, is a Simple Word Processing 
program for the Spectrum, allowing text of 
up to approx 11,000 characters (about 3 
A4 pages) top be entered, edited and 
printed to screen, ZX Printer, or, with an 
appropriate interface, a full size Printer. 
The text can also be saved and reloaded as 
required. 

The program should be entered as 
listed, omitting all REM’s, and save the 
program before Running. To Start ZX 
Words RUN 9500, this will set up graphics 
for cursors and poke the machine code 
break disable routine into place. | suggest 
that, until you have checked that your ver- 
sion works, you change Line 3770 to:- 9770 
REM RANDOMISE USR 65110, deleting 
the REM only when you are happy that 
everything is OK. Your final Version should 


be saved by GOTO 9999, this will ensure | 


that on loading ZX Words will run auto- 
matically. 


Instructions for use 


On Loading you will be presented with a 
Menu, Option 1 of which will be enclosed in 
a bright box. To select an option this box is 
moved down with the space key and an 
option selected with the Enter Key. 
Option 8 will show all commands avail- 
able with RUN Words. except:- 
In Print Mode: holding ‘S’ will pause print at 
the end of the current Line; ‘C’ will COPY 
page to ZX Printer; ‘Q’ will QUIT printing. 
Note. To exit from Entry Mode use Caps 
Shift + 3. 


Program structure 


Text is entered and held in a single dimen- 
sion array A$(Len) where Len is selectable 
according to the maximum length of text to 
be entered. (default = 9000). Characters 
are typed straight onto the screen via an IN 
KEY$ routine. 


Location of ZX Word’s major routines. 


Line 


100/110 Capital Lock, On/Off. 


If anyone would like a Copy of this program 
and does not wish to type it in | will be 
happy to supply a copy on cassette for 
£4.00 (inc p&p) from 25 Lucy Close, Stan- 
way, Colchester. 


s 2 J 
Loading instructions 
LOAD ”” 
On loading you are presented with a Title 


4900 to 4999 
5000 to 6100 


Quit. 


Page/Menu. This has 
options:- 

Print Text. 

Continue with Text. 

Start new Text. 

Edit Text. 

Save Text. 

Load Text. 

Quit. 

Help/Set up. 


the following 


130/140 

150 

120 

1000 to 1030 
1040 to 1099 
2000 to 2180 
2200 to 2600 


3000 to 3070 
4500 to 4530 
4700 to 4720 
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General Purpose Single Character Input routine. 

Print Page of text with Edit Cursor. 

Print Page without Cursors. 

Main Text Input Loop. 

Commands during Entry. 

Instruction Pages (3) 

Rename Text —Set Line Length—Set Text Length 

option selected by bright cursor. 

MAIN MENU and Option Selection. 

Save and Verify. 

Load Text. Change these two routines if 
Using Microdrive for text store 


6100 to 7110 
8000 to 8190 
9000 to 9010 
9500 to 9550 
9700 to 9770 


Edit Mode Cursor and Command Loop 

Various Editing Sub Routines. 

Print Text. Prints text to Screen or Printer. 

Clear Text and Reset Variables. 

Set up Graphics for Cursors. 

Break Disable Routine. This is an interrupt 

driven routine that checks for Break keys 

and if pressed forces a CONTINE to be executed. 
This routine could be used in any Basic program 
To turn Break Disable ON use RAND USR 65110 
To turn Break Disable OFF use RAND USR 65120 
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FEATURE 


Option 1 will be in a bright box, this is the 
Option Cursor, to select an item from the 
list use the SPACE key to move the Cursor 
down the list, then, when on the correct 
option press ENTER. 

When the program is first loaded no text 

| will be present, 
On side 2 of the tape, the program con- 
| tains an example text; it is suggested that 
this is loaded when the program is used for 
the first time. 


° 

Options 

1. Print Text 

This will allow the text to be printed, either 

to the screen or to a printer. For use with a. 

printer other than the Sinclair please refer 

to the notes at the end of these 
| instructions. 

To the question Printer ? [Y or N] *Y’ will 

| turn on the printer, any other input will 
select the screen, : 

To the Question, Characters per line? 

| the current number is show and pressing 
ENTER will leave this unchanged. To 
change this type number then ENTER. The 
ZX Printer will print a maximum of 32 
| characters per line, but shorter lines can be 
chosen. For other printers much longer 
| lines can be used. 

The text will then be printed as required, 
at the end touching any key will return to 
the menu. During printing holding down 
the 'S’ key will pause the printing at the end 


un GOTO 3500 


23658. (PEEK 23658 


nm 
a2=a THEN POKE 


ot gl Aa 
Outs 


“Or $= THEN 


THEN USE COTG 3 


iNK Ge-C ge 


of the next line. 

The ‘C’ key will copy the screen to the 
printer, and clear the screen. 

The ‘Q’ key will return to the menu. 


2. Continue with Text 
This is the main text entry option, and also 
allows more text to be added to an existing 
document. A display of space left is shown 
at top Right Corner of the screen. 

A‘C’ in the top Left Corner indicates that 
CAPS LOCK is ON. 
_ The next letter will be typed in the posi- 


tion indicated by a ‘*’. 


During entry of text some of the Number 
keys when used with the CAPS SHIFT key 


have different functions as below. 
1 = Select EDIT MODE. 
2 = Caps Lock ON/OFF. 


3 = Return to MAIN MENU. 


| 4. = Turn BACK 1 PAGE. 


9 = Turn FORWARD 1 PAGE. 
0 = CORRECT last Character. (Will repeat 
if held down.) 
ENTER will give a definite New Line. To 


‘indent a paragraph during printing leave 3 


spaces after using ENTER. The position of 
an ENTER Character on the display is indi- 
cated by a small dot. 

To add to an existing text use CAPS 
SHIFT + 9 to locate the * and then start 
typing. 


3. Start New Text 
This will clear the existing document and 
ask for a name for a new one. (Max. 10 let- 


L. BS 
1, Ba: LET Bei v.78) is 
70 PRINT AT 1 
Oo REM 


oor CLE : POKE 23658,0 


»Opablpage-639 TU 
DISPLAY AND INPUT 


ters). Then you are returned to the menu. 


4. Edit Text : 
To edit your text this mode is selected 
either from the Menu or by Caps Shift + 3 
from Option 2 Text Entry. 

The cursor is moved to the point to be 
edited with the following keys (No SHIFT) 
2 = To middie line. 

3 = To page end. 

4 = Turn back 1 page. 

5 to 8 = As arrows above keys. 

9 = Turn forward one page. 

0 = Tostart of page. 

or 5 (Search) then type incorrect word or 
part of word ENTER, a search is then made 
from the current cursor point for those 
letters. 


Note. The cursor is marked by a box 
around that letter. 

When the cursor is at the required point 
then the following options may be selected 
by touching key:~ 
C = Change the letter in the cursor. The 
cursor will advance 1 character after each 


! change. To return to cursor move press 


ENTER. 
1 = Insert. To insert a letter(s) 1 Character | 
behind the cursor, ENTER to end. 

P = Insert paragraph marker. To force a 
new line during printing. 

D = Delete, then L deletes the letter in the 
cursor. W deletes the word starting at the 
cursor. S deletes the sentence (to the 
next'.’) storing this for later use. Again 
ENTER returns you to cursor movement. 

L = Look at stored sentence. 

R = Replace sentence starting at cursor | 
position, moving all the text up to make | 
room. 

X = return to either menu or Text entry. 


5. Save Text 
This will save the document to tape with 
name given in option 3 or 8. 


6. Load Text 

To reload previous work, name of work 
can be a name given to a document on 
tape or just ENTER to load the next docu- 
ment on the tape sequence. 


7. Quit 
Ends use of Program. 


8. Help/Set up 

This gives 3 pages of information on com- 
mands available, then the option to change 
the name of the current document, Line 
length, or max Text length (with effect from 
next new document). 

To change program for a different 
printer, line 8000 will need to be changed 
to select between screen and printer, and | 
Line 8140 to send text to printer. 


P 
1 RETURN 


page): RETURN 


PRINT &£1;AT 1,0; PAPER 4; INK 9; “ENTRY MODE 


IT AT 0,3, "Page 
REM MAIN LOOP 
it ) LET a®fcur} 
CURs Lie 


}-8: PRINT AT 6,03 1B 
BEEP 2,10: RETURN 


30 TO 130 
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4°) PRINT AT 1, 0;A8( PAGE - 


1030 LET I®=INKEY#: LET i=CODE it: IF I#=" 


ppage/640 AT 0,14; "Space Left = 


339 TO PAGE) ;AT 6, 26;STR® (LEN- 


THEN GO TO 1030 
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1033 BEEP ,01.10: IF 17127 
1036 LET AS(CUR) =: LET CUR*CUR+1: LF CUR>=PAGE THEN LET PAGE®PAGE+320:;: 
PRINT AT O, 8, INT (.54tpage/64031; “3 EF pagevtten THEN PRINT £13AT 1,0; 
FLASH 15° NO MORE ROOM “4 FAUSE $00: RETURN 
10328 GO Tt 1626 
1039 REM COMMAND CHECKING. 
1040 LET ASICURJ=" “: LF i=§ THEN GO SUB 100: GO TO 1030 
1050 IF 1*i2 THEN LET a®(cur-1 TO 93 “: LET cur=cur-i: GO TO 1020 
1060 IF 1=13 THEN LET A#(CURI””_Grannic. § LET CUR INT CUF-LI/32b#32es 
3: (Ff CUR>=PAGE THEN LET PAGE=PAGE+320: PRINT AT 0,@:INT (.5+! page/640)); 
“: IF page>ien THEN LET page=lent 
1061 LF cur stan THEN PRINT £1; FLASH 1;AT 1.0; °NO MORE ROOM“ 
RETURN 
1065 IF I=13 THEN GO TO 10 
$070 IF i=7/ THEN LET AbiCUR “: GO Suk S060: 
1080 LF THEN BEEP },°10: RETURN 
1090 IF I=S THEN BEEF 1,0: LET page=page-640: 
=640 
1095 IF 
aerlen 
1096 PRINT AT 0.8; page/640; 
1094 HEEP «2,20: GO TG 1026 
19993 REM HELP PAGES AND SETTINGS 
2000 CLS : PRINT TAB 10;"“2X WORDS" BRIGHT 1; "Commands from Entry Moae 
“010 PRINT CARS SHIFT + © “Ll = Gato Edit Mone” "2 = Caps Lock ON/OFF” ‘3 
= Return ta Main Menw 4 = Hack | page” “% = Forward 1 sage’ 0 = Cprrec 
See nnnetes "ENTER * New Line /¢ Paragrapr 
4 spaces at start of line tol laware 


OR 1432 THEN CO TO 1040 


PAUSE 3500: 


GG TH 1016 
IF page<=640 THEN LET page 


I-15 THEN HEEP 1,9: LET page=page+os0: IF pages=ien THEN LET pag 


1 last Cnuracter 
(To andent paragraph 
a ENTER, ) 
2020 PAUSE 30: 
BS2/6=255 AND 1N 32766) 
a LET b=121 CLS : 
AT 1,03" KEY MODE 


leave 
PRINT £14AT 1,9; 'Prags a key to continue’: IF INKkr="" AND 
5 THEN oO TU 2026 
PRINT BRIGHT 1: Commands from EDIT MODE” 
ACTION REGUIRED’;AT 1,0: OVER tyo___ 


sTOH at Change";TAH be "Enter " = Ena” 
“D°3;TAH aj "Delete® : TAH o7°b © Singie Latter 
Sentance(Storeo :TaB pi"tor later ule) 

Enter” 
2070 PRINT 
“08G PRINT 
YO PRINT 
4260 PRINT 
16 PRINT 


“3TAB pe" "Enter > Ena 
TAB bs at stored senturce 
gTah & Pt Paras Park 


Insert 
LooK 
‘Faragr apr 
Replace 
Seuren” 


In x 
PRINT #RIGHT Ls 2OLT 
2150 PRINT “KET ACTION gat 2.08 
2160 FPH.NT "2 - To Micdle cre 
“S-é As Arraws” 3 Forwarc & Piue 
2470 PRINT tThete NO SrLlPT KEYS Usenj 
2180 PAUSE UG: PRINT £1347 1.05 "Presi aw vey t 
LN BS2780055 AND IN 34.2/66= THEN 10) The 2 
2200 KEM SET UP 
2 LET b> 03 
2225 FOR a=1 To 5 
2230 PRINT AT 3, Test Name 3 FAB 364 
="3 TAB hitha Mas Trext Length Max 120 STAR oseer 
2235 PRINT To Seiect Jotion.' "Pra NOace vEV ta sarente e1IsHN 
then press Enter 
2240 PRINT OVER 13 


MENU 
bytp 


Conte 


FRINT HRAGHT 12: SET wk DETAILS 


AUT 


BRIGHT J:AT 362.0: _Graphag © urapnic jp 


f pean As sraphjc_U yrap! 


IF TRKET Se 


iF OINKET4= PRINT AT aezs 


THEN 


TF INKEY$=CHR* 43 THEN GH Ty 2290 
OO TG = 

RESTORE a EC a= TO 1 STEP 
DATA 2310. 2400, 2500, “600 

RETURN 
INPUT 
TO 10) 
PRINT AT <5, by 

GO TO 2200 

INPUT ‘New Lane Lengtn 


"Enter New Wame (Max 10 Letters; ‘5: beiD Tey 


(20 Pranter = 323 “tena: OLM mbichatre 


INPUT New Text Langen tam work as ctearad) tian 
Qo 

STOP 

REM MAIN MENU 

CLS ; PRINT AT 1,102 2X WORDS 

PLOT @, 188: DRAW 240,07 DRAW OG. - 7% 

FOR avi TO 4+ PRINT OVER 1y INK 

: NEXT a 
PAPER Gy INK 13 


twill @ppry mext 


A Worn Frocessing Priugram 
BRéw -240,0: GRAW 3,2. 
FAPER ©: BRIGHT 1: AT 


wide 


PRINT AT 6.10; ‘Mensa UJoticdne ¢ UVER .:AT 
FOR i-1 TO @: 


PRINT AT &.0;'°1, PRINT TEXT." ° Ut, SONTENUE wiTk TEXT. js START Ntw 


PRINT “4. EDIT TEXT. S. GAVE TEX LOAD Vert. web ie 3 
/ SeT UP 
PRINT Current work = tc 
PRINT To Select Uption.” 
#n press Entor 
3041 PRINT AT 741,0% BRIGHT 1; OVEX 1s _Srap 
Nas. Graphic Dovraphic D Graphic b Grareic 
D Graenics D Graphic Bb Grapnic Ob yeapnic 0 yraghis. 
@pbac D Grapnic ) Grapnis 2 yraphic £ 
3042 IF INKEY#*"" THEN GO TG 3042 
3043 IF INKEY$r° THEN PRINT AT 7*1,0: 
t NEXT I: GO 74) 3019 
3045 IF LNKEYS sri 12 THEN Go TO 
3046 ud TQ 3042 
HEEP «5,121 CLS 
1 i) FOR Avot TO Ls #eAly B: ; Ae 3 oO Ty 3900 
n000. 4500, 4°00. 4: “ 


“Frese space rev ta seceoten 


bo Gratin 


ada 


TQ tenesobs Lit abtten-s0 TO .en-.0/-STR& curs SAVE 


3410/53 50 SVE 130 
“Eft erro: occurs 


soc0 PRINT &i:AT 
ye "V" OF Be wy 
yor Lota 4519 
45.30 WETLEN 
4/00 REM Loaa At 
A740 INPUT Name cfr Worx to be igacdet? “ixe 
7 PRINT “Piavy Tape NOW If Louw Error press CONT and 
LOAD x4 DATA abi: LET ten=LEN at: LET x#=ad(ten-9 TO 
at(ten-16 TO ten-10): GO TO 3010 
PRINT €X WORDS” Seectrum WORD PROCESSOR "i 
LUCY CLOSE” “STANWAT" “COLCHESTER” "ESSEX 
agg STOP 
S000 HEM EDIT ROWTINES 
3010; CLS : DIM Be(G401: 
5020 GO SUB 110: PFINT £1;AT 1,03 PAPER 2: INK 
R MOVE 
3030 IF CURICL THEN LET CURI=L 
S040 LF CURL>PAGE THEN LET PAGE=PAGE +640: 
3045 GO SuH 150 


1,0; To Verity press vi" Cotner= 
THEN PRINT Start Tape Plavine NOW. 
ty Re-reord, VERIE «® DATA at() 


Piay Tuo 
tend: LET 
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LET PAGE=640; LET CURi*) 


73° EDLT MODE"; TAB 21; "CURSU 


LET CuR1=CURI-£40 


* 8170 IF 


5050 LET it INBREYS: IF i6= THEN 30 TO 35086 
S035 LET I=CODE 14-46%: 1F I<C OR 1510 THEN GO TU S156 
S060 LET CURI=CURL+(1=8)-11#S): IF [=5 OR 1=8 THEN GO TO 5020 
S070 IF l=6 THEN LET CURI=CUREeL so Ti) 5030 
f= ThEN LET CYUR1=CURL -3. s0 TO 5050 
e THEN LET CURI=640: GO TO 5036 
Te2 THEN LET CURI=321: 00 TO 3030 
I=O THEN LET CURI©1: GO TO 5030 
I=3 THEN LET PAGE=PAGE +640: LET CiRin4 
d=4 THEN LET PAGE=PAGE- 40: LET CURI=1 
F PAGES640 THEN LET PAGE=640 
cur>len THEN LET cur=ien 
THEN BEEP 12,4: RETURN 
=cur l¢{page- £40) 
“ THEN WEEP 12, ICODE 1%-60): GO To 7100 
THEN BEEP (CODE i4-60): GO TO 7000 
THEN BEE? i%-60): TO 6300 
THEN BEEF .2, (CODE 1%-60): TO 6400 
THEN BEEP » (CODE 3a$-60): CO TO 6600 
THEN HEEP »iCODE i%-GG): GO TO &700 
THEN HEEP .2,{CODE i%-G0): Go T) 6900 
6100 BEEP ery Go TO 5020 
6200 REM INSERT 
5 SUB 166: 
SUR 150 
SUH 130: 


PRINT £2;AT 1,14; PAPER Sj; INSERT “-ENTERTEND""” 
IF I=13 ThEN GO SUB 110: 
> 4=6 THEN GO SUB 100: GU TO 6324 
6430 LET ASiCURS+! TO CURe1/=A‘(CUR2 TO CUR): LET AS(CUR?)=18: 
Reet: LET CUR=CUR+1: LET CURI=CUR1+1: GO TC 6320 

6400 REM CHANGE 
£410 GO SUB i00: 


GO TO 5020 


LET cu 


PRINT &1;AT 1,14; PAPER 3; “CHANGE ENTER=END™ 
6420 GO SUB 150: GO SUB 330: IF leis TREN GO SUB lif: GQ TO S020 
30 ff I=6 THEN GO SUB 100: GO TO 6420 
6490 LET ASLCURZ)=1l4%2 LET CURDZ*©CURZ+1: LET CURI=CURI+1: GO TO 6420 
6600 PRINT €1:AT 1,155 INK Gy REPLACE”: LET A$(CURZ+4LEN MH TO CUR+LEN MB) 
At(Cuk? TO CUBI: LET AS(CURD TO CURZ4LEN M$-li=M$: LET CUR=CUR+LEN M4: 
6610 UG TO 5020 
REM celete 
PRINT €1:AT 1,14; PAPER 3: 
GO SUH 156: GO UE 130 
FoIdi: LD THEN LET 
GUE CUke a 
THEN iets shoo 
TREN LET &biCuk 


“DELETE iL. WOR SI” 


Th 3aud 
LF At LAY 
RrisAT 1.143 


Tet GO TO Gt 
FLASH oa Ne fo ahieh 


FOR A® ume 
6620 NEXT A: FRINT 
oO Tu 6700 
66235 [bE ablAris:.” apr eT asael 
6230 LET A=Ael: FAMICURS Ti) Al: LET @siiurL Ta 
URI) ) 
6840 BET curscur-LeN mbeds GC TO 6F 00 
6300 CLS : PRINT “Storect Text Tar Repia: emer t 
6910 PAUSE 250; CLS : WU TO SG20 
7000 REM SEARCH 
7910 GO Sub 100: 
F020 FOR A=Cukz+ 
7039 NEXT Ay GG TO 5020 
7040 IF AxG640 THEN LET CURIA: 
7050 LET A=A-640: GO TO 7046 
7100 LET 1$="_Grpohic 8° 
F110 LET CH2AB(CURZ TO CUR): LET akiCuk2) 
413 LET CURL=CURIG/: LET ASL(CURKS TO CUR? 
8000 PRINT €1i°Pranter? Cy or WH 
= 43 
PRINT “Numper af craeacters opr rane iéX Printer ma 
To chanue enter new numper Fress entar oniv te eave 
LINE if: IF 18<¢ THEN LET cra=VAL 16 
GOOS CLE : PRINT “Te print trom tne start ot a 
Page No then ENTER” “Press ENTLR oniy tor prant 
itr IF Lon THEN G0) TG 8010 
8006 LET 1=(VAL 1%-5)4640: IF asien GR 1is640 OR [Cur THEN Gu 10 900% 
$8007 LET w=i: CLS 2 LET 9-0: GU TO GO36 
8010 CLS 
8020 LET #70: 
8030 LET ST#4 
8035 IF AS(STI< 
8040 LET ST=ST+ir 
S050 IF A®iST)= 
8060 If P=i THEN 
8065 REM FIND LAT 
8070 FOR BeST+CcHA-1 
LET Pei: GO TO 8100 
808C NEXT H: LET END=ST+4CHA-1 
80390 IF AMIENDS= OR AS(END+t) =” OR ABLENDI= ,° UR aSitNOr 
OR AS(END)="," OR ASIEND)* ">" OR AtCEND)= UP PeLTND, s OF iG 
3° THEN GO TY) $100 
8092 LET END=END-1: 
8094 IF END<;ST THEN 
8096 LET ST=A+CHA-1 
$100 LET (=0: IF At{END)="‘_Graphac tt z 
8120 KEM IF DIFFERENT PRINTER USED 4 ak LINt @140 Ti: ¥ 
TYFE OR CHANGE PR TO GUTPUT TO & Diff ERENT OATA STREAM 


INPUT 
TO Que: 1F 


FAPIR 52 °SEARCH CEKTLP WORD? 
A4(4 TO Atlys Th Triity LET 


Ge TO SOL6 


pagd 
tram 


hathar 
Start 


tlwan Qt Twos 


INPWT LIN 


LET A312 REM FIND FIRST Ch 
THEN GO TO 8070 

IF ST=A¥ChA-1 THEN LET 
THEN GU TO 4040 

LET P=0: IF A¥IST-3 TO ST-P)=° TEN LET uT=ST- 

1ST CHEGK FOR PARAGRAPH MARKER 

TO ST STEP +1: Le AS(H)= _Grpehic F 


STeAa GU Ty SCG: BEM kMeTI Ld tye 


Tria Lb Tob iwide as 


IF A¥.ELNDI=" 
GU TO B0G2 


TeeEN GO 


6140 PRINT d&przasiST TO END? 
$145 LF PR=2 THEN PORE 23692, 
8146 IF ENKEY$="C" THEN COPY : CLS 
8147 [fF LNKEY#2°S' THEN GO TD 8147 
8146 IF INKEtt="@' THEN GO TO €140 
8150 LET A=ENDeiei: 1F ASCUR THEN 
8160 LF prvo THEN PRINT £13' Frese 
8165 IF PR<3 THEN GO TO 8130 
INKEY4="" AND IN Et 9-255 ANL IN iu? 295 THe uG Tu 412 
SivO-DIM Nei CHAs1) : RETURN 
9¢00 CLS : INFLUT. ‘Name for this) paece of work 
IF LEN «$210 THEN LET x¥=x0d TO 10: 
S005 LET lam=2NT Clerns6407#640+640: LET CUR'1: DIM AS(LEN+ 25): 
9010 LET cna*3l: DIM n@icha): LET m$=“~: LET pacueé40: RETURN 
3500 RESTORE 9500: FOR A=0 TO 331 READ Bs FOKE USR “A“+A,B: NEXT A 
9510 DATA 255,129, 125, 129, 129, 29,129,255: REM GRAPHICS A=_Grarnhar 4 
9520 DATA 0.0,9,0,0,0,0,12G: REM GRAPHICS B= phat B 
9530 DATA 255, 128,125, 126, 128,128, 126,255: REM GRAPHICS C=_Graphic © 
$540 DATA 285.0,0-9,0.0,0,255: REM GRAPHICS D=_Graphic D0 
S50 DATA 255, 1,1, 141,411,255: REM GRAPHICS E=_Graphic E 
3600 CLEAR 65109: RESTORE 9600: PRINT “Please Wait” 
9710 FOR A=65110 TO 65126: READ B: POKE A,B: NEXT A 
9720 READ C: LET C=C+65128; FOR A=65129 TO C: READ Br 
30 DATA 62,9, 237,71, 237,94, 201 
DATA 0.0, 0,62, 621 237,71; 237) 86. 201,0,0 
DATA 56, 245, 48,58, 92, 254, 20, 40,4, 241, 195, 56, 0, 205, 176, 20, 42, 89, 
22,35, 62, 232; 1i9, 241,241, 253,32, 13, 1.340, 17. 112, 92, 33, 68, 92, 2539, 
237, 184, 253,54, 10,255, 251, 195,244,18: REM preak disahbie 
” RANDOMIZE USR 65110 
LET x#="Empty Pad"; LET len=9000: 
REM tt eeeeeeeeteeeeeeeeneee 
REM copyright ALAN D, WENT 1984 
REM #8 eee FERED CORRE RESO RE 
CLEAR : SAVE "2X Words" LINE 9500: STOF 


GO TO S020 
a xevy te continue 


{Max. 10 Letters!" :<#: 


POKE A,B: NEXT A 


GO SUB 9005: GO TO 3000 


ROBOTS PAST, PRESENT AND FUTURE AT THE 
VICTORIA & AISERT MUSEUM 
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Victoria and Albert Museum 
Langdon 
Until Octobr 


Admission free 


WIN A FISCHERTE 


Your Robot will be supporting the Fischertechnik robot 
building kit with a series of projects over the next few 
months — we think the kit offers an excellent introduction 
to the world of robotics. 

We’ve two kits to give away in this month's Your Robot 
competition. 


WORKSHOP FOR 
ROBOT BUILDERS 


From the first of this manth, 127 Ifiete 
Road, London, SW10, has provided 
a showcase for the numerous smail 
robots used in education and training. 

The workshap is sponsored and 
funded by The Entryahone Company 
and their managing director, Gordan 
Ashbee, hopes that the workshop 
wii! become a meeting place for 
those interested in low cost robotics 
equioment, He is particularly kean to 
talk to anyone experimenting with 
robots or related equipment. 

The workshop can be re 
01-373 8571. 
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HNIK ROBOT KIT 


How to enter 


In not more than 50 words describe an application for a 
robot based on the Fischertechnik robot kit. 


There are two prizes to be awarded 


one to an 


individual and the other to a group entry from a school or 


college. 


Write your entry on a piece of paper together with your name and address — or that of your school in the case of a 


group entry — and send to Fischertechnik Competition, Your Robot, 155 Farringdon Road, London EC1R 3AD. 
No EMAP employee may enter the competition and the editor's decision in all aspects will be final. Closing 


date for entries, October 31st. 


Your Robot, 155 Farringdon Road, London EC1R 3AD. Editor: Gaig. Evans. Deputy Editor: William Owen. Production Editor: Liz Gregory, Advertisement Manager: 


Richard Jans7, Advertisement Production: Yvonne Mayser, 
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WIND INSULATING TAPE 
AROUND SPINDLE—THIS 
INCREASES DIAMETER 
AND IMPROVES TRACTION 


THIN BAND INTO PULLEYS 


OR 
THICK BAND ONTO BLOCK 
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LEGO PLATE 


PLASTIC METAL IN 
HOLLOW “ROUND BRICK 


UPRIGHT 


D@ (ON/OFF) 


D1 (DIRECTION) 


CENTRONICS 
PORT 


+5 TO +12V 


2k2—10k 


IDENTICAL 
CIRCUIT 


Figure 4. This circuit is required if the motor needs a high DC voltage. 
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LISTING 1. A small turtle interpreter. 


10 REM SIMPLE LAUREL RECOGNISES F - FORWARD 8B - BACKWARD 
20 REM R - RIGHT 90’ L - LEFT 90° 
30 REM S- STOP. 

40 LET RD=20: LET LD=20; REM RD&LD ARE THE.TURN DELAYS 
42 LET MD=20: REM MD IS THE ONE-UNIT-OF=MOVE DELAY 

60 CLS : READ COM: DIM ACCOM) 

70 FOR N=1 TO COM 

75 READ A$(N): READ ACN): NEXT N 

80 INPUT B$: IF B$="0" THEN STOP 

90 IF B$="** THEN GOTO 80 

100 LET N=1: LET X=LEN(B$) 

110 IF B$(1)=A$(N) THEN GOTO 140 

120 LET N=N+l: IF N>COM THEN GOTO 80 

130 GOTO 110 

140 LET B$=RIGHT$(B$,X-1): LET K=1 

150 IF RIGHT$(B$,X=-K)<"0" OR RIGHT$(B$,X-K)>"9" THEN GOTO 180 
160 LET K=K+1: GOTO 150 

180 LET K=K-1: IF K=LEN(B$) THEN LET V=VAL(B$): GOTO 200 
181 IF K=LEN(B$) THEN LET V=VAL(B$): GOTO 200 

190 LET V=VALC(LEFT$(B$,X-K=1)): LET B$=RIGHT$(B$,X-K~1) 
200 ON ACN) GOTO 300,400, 500,600, 700 

210 DATA 5,F,0,B,1,8,2,L,3,8,4 

219 REM MOVE TIME PERIOD 

220 FOR Z=1 TO V 

222 FOR W=1 TO MD: NEXT W 

224 NEXT Z 

226 RETURN 

279 REM TURN TO RIGHT TIME PERIOD 

280 FOR W=1 TO RD: NEXT W 

282 RETURN 

289 REM TURN TO LEFT TIME PERIOD 

290 FOR W=1 TO LD: NEXT W 

292 RETURN 

299 REM FORWARDS 

300 LPRINT CIR$(5): GOSUB 220: LPRINT CHR$(0): GOTO 90 
399 REM BACKWARDS 

400 LPRINT CHR$(15): GOSUB 220: LPRINT CHR$(0): GOTO 90 
499 REM RIGHT 90! 

500 LPRINT CHR$(4): GOSUB 280: LPRINT CHRS$(0): GOTO 90 
600 LPRINT CHR$(1): GOSUB 290: LPRINT CHR$(0): GOTO 90 
699 REM STOP 

700 LPRINT CHR$(O): GOTO 90 

REM LEFT 90! 


could be started at once. Extra lines such 
as: 


122 IF V$=“Q”" THENLPRINT CHR$(5) 
124 IF V$=“C”" THEN LPRINT 
CHR$(15) 


will provide this facility, but to do the same 
for turning and pivoting simply means hav- 
ing to remember more and more keypres- 
ses, and you will end up looking at the 
keyboard 90% of the time. To overcome 
these and other problems, turtles have 
their own command language which 
enables them to be driven efficiently, to 
perform automatic sequences of move- 
ment, and to remember entire “journeys”. 


MOVING GRAPHICALLY 


A Command Language can be written in 
Basic and tested on the computer screen 
before letting loose Laurel to blunder its 
way across that square yard of pristine- 
white sugar-paper. If you have a Spectrum 
or a Dragon you might like to dig around for 
E&CM May 1983 and read Mike James’ 
article “The Computer Brain”, where an 
idea known as “chain coding” is discussed 
at some length. Chain coding is the basis 
of languages like Logo and is also the con- 
cept behind the Dragon's graphics com- 
mands. When applied to crawling robots it 
gives a list of movement instructions which 
are obeyed in strict order to build up 
shapes and patterns in the way that 
humans would draw them, or pace them 


“Any extension fo Laurel's 
command language is 
very simple”. 


out on the ground. Thus a Logo listing 
might read more like instructions for find- 
ing buried treasure than the more old- 
fashioned Basics which work on a great 
number of meaningless screen co-ordi- 


nates. and LEFT$ to step through the turtle- | simple: the new letter and subroutine 
movement instructions which are fed by | number are tacked onto the end of the 


LOGO DRAWS A SQUARE the user into B$. B$ can be as long as your | DATA statement, and the appropriate sub- 


computer will allow and is a string made up | routine is allocated (line 200) and then of 


START AT 20,20 of <letter,number(s)> sequence, entered | course, written. 

REPEAT 4 TIMES: without spaces. Letters should be upper | The numbers which are given after the 
TURTLE FORWARD 10 UNITS case, and numbers should be integers. At | commands F and B represent units of time || 
ROTATE TURTLE 90 DEGREES least one digit should separate each letter: | during which Laurel's motors are ON. A | 

ae there is no error-checking in this simple | single unit of time has a length proportional 


program, so you must enter the instruction | to the value of MD (line 42). Commands R, 
The above is a program which could be | codes carefully into BS. L and S do not use numbers, but require 
considered elegant. In reality the listing Legal letters are F,B,R,L and S for For- | some dummy vatue to be typed in. The 
would be ashorthand version sothat it was | wards, Backwards, Right turn, Left turn | values RD and LD in line 40 should be 
economical in its use of computer memory. | and Stop —- 5 commands in all. Each com- | adjusted until it represents a time period 
If the starting co-ordinates were omitted, | mand has a subroutine, numbered 0-4, | which causes Laurel to turn through ninety 
the square would be drawn from the | assigned to it, and the “command table” of | degrees. Obviously the values RD, LD and | 
turtle’s present position. legal letters and subroutines is contained | MD will vary depending on the model of | 

Logo nas recently been implemented on | in the DATA statement at line 210. The first | computer you are using, and their adjust- 
a number of home micros, including the | item, 5, is the number of commands. Then | mentis very much acase of trial-and-error. | 
Sinclair Spectrum and the Amstrad } comes each command letter, followed by Laurel is too small to have sensors fitted 
CPC464. We will have to be content with a | its subroutine number. Line 200 directs the | to it, and it’s a nuisance not being able to 
small interpreter, written in Basic, which | program flow to the correct subroutine. | raise its pen to stop its tracing activities: 
uses chain code to drive the Laurel Turtle. | Subroutine 0 is at line 300, subroutine 2 is | next month we'll return to LEGO with a} 
The code is written in MTX Basic whichis a | at line 400 and so on. Any extension to | vengence and start building a 4-motor 
pretty standard Basic, and uses RIGHT$ ! Laurel’s command language is very | floor buggy which can. 
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FISCHERTECHNICK 


ROBOTS 


Richard Sargent has built one of the devices from the range of robots that can 
be constructed from the new Fischertechick robot builder's kit. 


Few people, | suppose, have had occasion 
to use Fischertechnick as a_ building 
medium unless they are involved in the 
teaching of Science, or have made up or 
otherwise modified ECONOMATIC's BBC- 
Buggy, which is made largely of Fischer- 
technik parts. Last month the new Robot 
package from the German firm was pre- 
viewed, and since then quite a few of us 
have been brushing up on our German and 
generally getting the feel of the kit by 
attempting to build one or more of the 
robot designs presented. 


THE KIT 


The kits on sale to the public will, of course, 
have their instructions written in clear, 
unambiguous English. To refresh your 
memories, here is the list of explained 
models which can be built up from the 
parts in the standard kit. There are naturally 
the proverbial 101 other designs which will 
occur to lateral thinkers (or those of you 
with time on your hands), but even budding 
Einsteins have to start somewhere! 


A “Tower of Hanoi”-playing Robot. 
A Solar tracking device. 

Apen plotter. 

A sorting machine. 

A graphics tablet. 

A 2-axis Robot arm with magnetic 
gripper. 


The kit is comprised of the plastic com- 
ponents, including two motors and two 
reduction gear-blocks, eight micro 
switches, two potentiometers, four lights, 
a great many little plugs (they go into the 
motors and the switches), some ribbon 
cable, and, thoughtfully, a small screwd- 
river for the plugs! Cynics will note that 
although a felt-tip pen is supplied for “Pen- 
Plotter”, a solar cell is not provided for 
“Solar-Tracking Device”! 


THE BITS 


The Fischertechnick building medium is 
easy to use and creates a very rigid final 
model. Inevitably comparisons with LEGO 
will be made, but the method of linkage 
between the Fischertechnick pieces is 
quite different, and it remains to be seen 
which of the two systems will be preferred 
for different types of model robot. The 


Fischertechnick Robot Builder kit lacks 
wheels and axles, and the LEGO ROBOTS 
currently being described in YOUR 
ROBOT could therefore not be built using 
Fischertechnick. 

The Robot Builder Kit is particularly well 
suited to the construction of open, vertical 
structures. The basic Fischertechnick 
piece is the channelled bar, the cross-sec- 
tion of which is always square (see Figure 
1). At its smallest size the bar is a 1.5cm 
cube and at its longest itis abeam 18cmin 
length. Figure 2 shows the method of fink- 
age between one bar and another. Unlike 
LEGO with its studs, Fischertechnick has 
no “top surface” and no “undersurface”. 
You can use it efficiently whichever way 


} DEH 
sia ste ped 


round it is angled. The bar-channels are 
cunningly designed to accept axles and 
there is no necessity for separate “tech- 
nical” bars or beams. The axles are made 
of metal and they run very smoothly in the 
channels. They can also be used as link- 
pieces to help join the bars together and 
this is an important factor where the 
strength of the final model is an overriding 
consideration. 


AND (SPECIAL) PIECES 


The Fischertechnick motor is a small but 
powerful beast, and runs happily on a 5V 
DC supply. It can be integrated into your 
model easily and its small size 


(60x20x15mm including reduction gears) 
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makes it possible to incorporate it into the 
structure of, for example, a robot arm. It is 
particularly efficient at driving a rack-and- 
pinion arrangement, or, by means of a 
worm-gear, driving a large turn-table unit. 
But perhaps the most useful pieces of all in 


holders. These provide the all-important 
feedback signal to the computer which can 
be used to calculate the robot’s actual 
position, This allows for great accuracy 
when the model is running — the software 
knows exactly where the mechanical bits 
and pieces are at any given moment, and 
cumulative errors caused by friction, exces- 
sive loading of joints, or even accidental 
sabotage by an inquisitive finger or two, 
can be detected and corrected. 

At least one of the potentiometers has 
full 360 degree travel, and gives a valid 
analogue voltage from all but about 30 of 
those degrees. However, your interface 
might not have the facility for Analogue to 
Digital conversion, in which case you 
would need to fall back on the micro- 


switches supplied and use them as limit 
switches to detect the end-of-travel situa- 
tions. Also in the kit is a Fischertechnick 
electro-magnet. The coil resistance is 30 
ohm and 5volts is sufficient to drive it. 


WHAT, NO MICRO? 


As is the case with LEGO, you can have 
many hours of fun running your Fischer- 
technik model directly from a low-voltage 
DC power supply or from three of four 1.5V 
batteries connected in series. Alternatively 
you can drive it successfully from the 
same interface that is used to run the 
LEGO robots. If you have a BBC B machine 
you will be able to read the robot’s poten- 
tiometers and evolve some simple soft- 
ware for making your model do some clever 
things. There is no doubt that the existence 
and availability of this type of robotics kit in 
Britain will enable people to take an active 
interest in computer-control experiments, 
and when the purpose-built interface and 
demonstration listings from Micro Robotic 
Systems Ltd are available we’ll put some of 
Fischertechnik’s little Robots through their 
paces. Perhaps a small workshop of Fis- 
chertechnik androids could help finish the 
LEGO ROBOTICS series... 
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While Pilot One may be accused of a cer- 
tain lack of imagination when it came to the 
naming of their new product, the chosen 
handle does have the advantage of 
simplicity. The name chosen was Interface 
and that term exactly describes the pro- 
duct. The unit connects to the user port of 
the BBC micro and provides four input and 
four output lines. 

Interface is housed in a two tone Vero 
box that will be a familiar sight to anyone 
who has had cause to find a home for one 
of their own DIY electronic projects. Inter- 
face has its own internal power supply and 
judging by the weight of the box, the trans- 
former chosen for the design is quite 
generously rated. This reflects the overall 
design philosophy behind Interface; it has 
been built to last and is as far as possible 
both child and idiot proof. Connection to 
the outside world is by way of a series of 
banana sockets mounted on either side of 
the unit. Each of the four input and four out- 
put lines has three sockets associated with 
it. In the case of the input side these are the 
three connections to a changeover relay. 

The output lines also have connections 
to the +5V power supply brought out to the 
same side of the box. The three input con- 
nections correspond to the input to a 
schmitt circuit in addition to the ground 
and +5V power lines. 

All of the lines are buffered and whatever 
accidents may happen during the course 
of driving equipment via the interface it is 
unlikely that any harm will come to the BBC 
micro. 

The top of the box has a series of mimic 
LEDs that give an immediate indication of 
the state of both the input and output lines. 


MANUAL DRIVE 


The manual that accompanies Interface 
provides a clear explanation of the opera- 
tion of the BBC micro’s user port and the 
way in which Interface works in conjunc- 
tion with the eight I/O lines of this port 
including a description of the Data Direc- 
tion Register. The manual goes on to 
describe some typical circuits that can be 
used to condition both input and output 


“Interface should 
prove robust enough 
for most environments”. 


signals. In terms of inputs these include cir- 
cuits to switch a buzzer on and off, a simple 
on/off motor driver and a circuit that allows 
a motor to be driven both forwards and 
backwards. Input circuits include those for 
both touch sensors and light sensors, the 
latter based around a MEL11 photodiode. 

Interface is supplied with a suite of 
software. This includes a collection of 
PROCedures incorporating the POKEs 
necessary to control the relays within easy 
to understand blocks of BASIC programs. 

The collection of software also includes 
a program called ‘INTCAR’ which allows 
the interface to run a two motor model car. 
The software assumes that the left motér is 
connected to lines PBO/PB1 and the right 
motor to PB2/3. The program allows the 
user to design a course on the screen and 
then to store this on tape or disk. The 
stored course can then be relayed either on 
screen or, through the interface, using a 
model car (the buggy described in this 
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issue of Your Robot would be ideal). 

Pilot One can also supply a crane and 
model Jeep suitable for use with interface 
(these are pictured on the front cover). The 
crane in particular provides an impressive 
illustration of the way in which computers 
can control the operation of a variety of 
equipment and in the way in which the 
physical action of equipment is related to 


the digital information output by the com- | 


puter. 
The Pilot One Interface is built to a high 


standard and should prove robust enough | | 


even for the most hostile of environments 
ie school classrooms. The software 
supplied allows the interface to be pro- 
grammed without recourse to machine 
code programming although it makes suf- 
ficient information available for those that 
may wish to control it in this way. 

Pilot One 

Victoria House 

46 St. Augustines Road 

Bedford 

MK40 2ND 


Interface specifications 

Internal power supply 1 Amp-short 
circuit protected 
Single pole 
c/orelays rated 
at 0.5A, 50V 
Opto-isolated 
(isolation voltage 
250V min). Drive 
current 10mA 
min. 

LED indication on all I/O lines. 


Output lines 


Input lines 


Load on BBC micro 12mA with ail lines at-} 


+5V. : 


Pe ee oy Se ety. See ee ees 
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FEATURE 


COMMODORE 64 SPLIT 


Ken McMahon uses interrupts to split the 
Commodore 64’s screen display into two 
windows — one in text mode, the other in 
multi-colour bit mapped mode. 


One of the more useful features of the 
Commodore 64's screen format is the abil- 
ity to use any one of three available screen 
modes depending on whatever particular 
application you have in mind. These are 
standard (or extended) text mode, bit map 
mode, and multicolour bit map mode. 

All very useful. But supposing you want 
to use more than one mode on the screen 
at the same time? For example, you might 
want to display hi-res graphics information 
on one part of the screen with accompany- 
ing text on another. This can be done with 
the aid of a short machine code routine 
which uses interrupts to change the con- 
figuration of certain registers in the VIC-II 
chip as and when required. 

In the main the registers we will be work- 
ing with are: 

1 The raster compare register at location 

53266 (HEX D012). 

2 The VIC control register at location 

53265 (HEX D011). 

3 The VIC interrupt flag register at location 

53273 (HEX DO19). 

4 The interrupt mask register at location 

53274 (HEX DOTA). 


The raster compare register talls the 
computer precisely where the screen is 
being drawn at any given moment. By writ- 
ing a value to this register we can Cause an 
interrupt (IRQ) to occur at a point when the 
position of the screen is equal to the value 
that has been written in. 

The control register determines the 
screen mode depending on the bit con- 
figuration within it. The particular bit we are 
interested in is bit 5 which enables bit map 
mode. The last two registers are both con- 
cerned with interrupts. The interrupt flag 
register sets certain bits when interrupts 
have occurred. The bit set depends on 
what triggered the interrupt. This time we 
are interested in bit 0 which is the raster 
compare IRQ flag. Correspondingly, bit 0 
of location 53274 is the raster compare 
IRQ mask bit; this must be set or the com- 
puter will ignore the raster interrupt when it 
occurs. 

If you do not have a machine code 
editor/assembler you will need to type in 
the whole of the BASIC listing program in 
Listing 1. (Remember to save the program 
before running it: the checksum is not infal- 
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lible!) Otherwise the assembly code can be 
typed in direct, although lines 200-340 of 
the basic program will still need entering in 
as these calculate the data for the graph 
and format the text output. 

When run the program will clear the 
screen down to the bottom three lines and 
start to draw the hi-res image — a spiral. : 
The x and y co-ordinates of each point are ; 
printed at the bottom of the screen as they 
are plotted. ‘ 


100 C000 LDA £;$00 
110 C002 STA Z;$FB 
120 C004 LDX £;$20 é 
130 C006 STA Z;$FC 


The first task is to assign an area of 
memory (8K) for the hi-res screen. The area 
to be used starts at location 8192 ($2000). 
This address has been deposited in page 3 
zero as it will need clearing later by filling it 
with zeros. The most economical way of 
doing this is to use indexed indirect 
addressing. This method also has the 
advantage that should the screen need to 
be moved elsewhere, all that has to be 
changed is the address pointer at location 
$FB. Register A has been used to load $FB 
and register X to load $FC; the reason for 
this will become apparent later. 


140 C008 LDY £;$00 
150 C008 STA(|).Y:$FB 
160 COOCINY; 

170 COODDONC,$FD 


Now the screen area can be cleared. 
Line 150 stores the contents of register A, 
which has already been loaded with 0, at 
the memory address pointed to by the turn 
page location $FB plus a displacement, Y. 
On each pass of the loop, Y is incremented 
to point to the next location. After 256 pas- 
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ses incrementing Y will cause it to equal 0, 
the condition in line 170 will no longer hold 
and the branch will not occur. 


180 COOF INC Z;$FC 


190 C011 DEX; 
200 C012 BNE;$F6 


LISTING 1. BASIC listing program. 
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This is all very weil, but only 256 bytes have 
been cleared and we need to do over 8000. 
Line 180 increments the high byte of the 
address pointer — an effective increment of 
256. We are now ready to clear the next 
256 byte block but before this can be done 
the block counter must be decremented. 
You will recall that | mentioned earlier there 
was a reason for using register X to load 
location $FC with the high byte of our 
address pointer. In order to fill 8K of 
memory with zeros 32 * 256 byte blocks 
must be filled. By coincidence register X 
now contains $20 (=32 decimal), so all we 
have to do is decrement it each time a 256 
byte block of memory is cleared. When this 
has occured 32 times X will decrement to 
0, the condition in line 200 will no longer 
hold and we can go on. 


210 
220 
230 
240 
250 
260 
270 


C014 LDX £:$04 
C016 STX Z;$FC 
C018 LDA £;$03 
CO1A LDY £;$00 
CO1C STA(ILY:$FB 
CO1E INY; 

CO1F BNE;$FB 
280 C021 INC Z;$FC 
290 C023 DEX; 

300 C024 BNE: $F6 


Having cleared the screen area the 
foreground and background colours for 
the hi-res image must be set. 

In bit map mode these are determined 
for each eight by eight bit square by the 
contents of locations 1024 — 2023 ($0400- 


FEATURE 


07E7), the place in memory usually 
occupied by the screen. The high four bits 
of each location control foregound colour; 
the low four, background colour. The same 
method used to clear the hi-res screen 
area is adopted. Our address pointer in 
page zero is loaded with address 1024 
($0400) via register X which is also used as 
a block counter (4*256= 1024), Each loca- 
tion from 1024 to 2023 is loaded with the 
value 03 which sets the foreground and 
background colours to black and cyan 
respectively. 


316 C026 SEI; 
320 C027 LDA £;$3B 
330 C029 STA;$0314 
340 C02C LDA £;$CO 
350 CO2E STA;$0315 
360 C031 CLI; 


Now we can get down to the real work. 
Locations $314 and $315 contain the 
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Commodore 64's hardware interrupt vec- 
tor. Whenever an interrupt occurs the pro- 
cessor branches to the two byte address 
contained at those locations. The vector 
needs to be altered so that it points to our 
program which begins at $CO3B. Before 
doing this it is necessary to disable the 
interrupts using the SAI instruction (which 
somewhat ambiguously stands for SEt 
Interrupts). The reason for this is to prevent 
an interrupt occuring when we are half way 
through the process of changing the vec- 
tor: this would result in havoc. 


Having redirected the vector the inter- 
rupts can be enabled using the instruction 
CLI (Clear Interrupts). 


370 C032 LDA;$D01A 
380 C035 ORA £;$01 
390 C037 STA;$D01A 
400 CO3A RTS; 


One last thing. We must set bit 0 of the 
interrupt mask register at location $DO1A 
otherwise the raster interrupt, when it 
occurs, will be ignored. Exit the program in 
the usual way with an RTS instruction. 


410 CO03B LDA;$D019 
420 .CO3E AND £;$01 
430 C040 C040 BEQ;$37 


So far we have cleared an 8K area of 
memory for the hi-res screen, set the 
colours, and altered the hardware IRQ vec- 
tor to point to a program at $CO3B. Well, 
this is it. Every time an interrupt occurs the 
computer will come to $CO3B, and it is this 
part of the program which will tell it what to 
put on the screen and where. The first thing 
to be determined when an interrupt has 
occurred is what triggered it, or, more pre- 
cisely, was it the raster compare IRQ? If it 
was, the raster compare IRQ flag will be set 
and it can be tested with an AND instruc- 
tion in line 420. 

If it wasn’t the raster which triggered the 
interrupt then it must have been something 
else and we branch out of the program to 
location $EA31 which is the IRQ vector to 
the usual interrupt handling routines. 


440 C042 STA,$D019 

Now we know that this is the real thing, 
and we must clear the raster IRQ flag. This 
is achieved by writing to it. 

450 C045 LDA;$D012 

460 C048 CMP £;$D0 

470 CO04A BCC;$18 


By reading the raster compare register 
we can discover where the screen was 


being drawn when the interrupt occurred. If 
the value in the raster compare register is 
greater than $D0 then we will be in the 
bottom three lines of screen — where we 
want to put our text. The carry flag will be 
set and the branch in line 470 will not 
occur. Conversely if the value in theyaster 
compare register is less than $D0 we will 
be in the top part of the screen and the pro- 
gram will branch to $C064 which con- 
figures the registers for bit map mode. 


480 CO4C LDA £;$01 
490 CO4E STA;$D012 


Having determined that we are at the 
bottom of the screen the raster compare 
register must be set so that the next inter- 
rupt occurs when the top of the screen is 
hit — at $01. 


500 C051 LDA;D018 

510 C054 AND £;$F7 

520 C056 STA;$D018 
530 C059 LDA;$D011 
540 COSC AND £;$DF 
550 CO5E STA;$D011 
560 C061 JMP;$EA31 


This part of the program simply sets the 
Commodore 64 to standard character 
mode. Lines 500-530 tell the VICI! chip that 
the screen is at the usual place (1024- 


LISTING 2. The machine code listing. 
LDA #3 #02 
STA Z,$FB 
LDX %; #20 
STA Z3$FC 
LDY % 20 
STACI) .Y;$FB 
INY; 

BNE; $FB 
INC Z3;$FC 
DEX: 

BNE; $F& 
LDX 3; $04 
STX 23$FC 
LDA 2 $03 


LDY 3; #00 


STA(I).Y¥;$FB 


INY; 

BNE: $FE 
INC Z;4FC 
DEX: 

BNE; $F6 
SEI; 

LDA #6 #35 
STA; #0314 
LDA ®; sco 
STA; 40315 
CLI; 


LDA; SDO1A 
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2023). Lines 540-560 turn off bit 5 of the 
VIC control register which, when set, 
enabies bit map mode. 

This is in effect the same thing as ‘set- 
ting’ standard character mode. Line 560 
sends the processor to location $EA31 
which is where it would have gone in the 
first place had it not been interrupted. 


570 C064 LDA £;$E0 
C066 STA;$D012 
C067 LDA;$D018 
CO6C ORA £;$08 
CO6E STA;$D018 
C071 LDA;$D011 
C074 ORA £;$20 
C076 STA;$D011 
650 C079 JMP;$EA31 
This part of the program deals with top 
screen work and does almost exactly the 
opposite of the preceding eight lines. 
Now that we are at the top of the screen 
the raster compare register must be set so 
the next interrupt occurs at the bottom — 


. $E0. The registers must the be configured 


for bit map mode. Lines 590-610 tell the 
VICI chip that the hi-res screen area is at 
location 8192 ($2000). Lines 620-640 set 
bit 5 of the VIC control register; ie set bit 
map mode. Once again we exit via the nor- 
mal IRQ vector at $EA31. 


ORA WW #21 
STA; #DO10 
RTS; 

LDA: $DO19 
AND 2; $01 
BEQ; $37 
STA, #0019 
LDA; #D@1i2 
CMP ak $00 
BCC; #16 
LDA $01 
STA: #DO12 
LDA; #D018 
AND 2X; $F7 
STA; $D018 
LDA; #DO11 
AND 2% #DF 
STAs $DO11 
IMPs SEAL 
LDA A; $60 
STA; $DB12 
LDA; #DB18 
ORA RG #0e 
STA; $DO1B 
LDA; #DO11 
ORA 3; #20 


STA; #D@11~- 


JMP: #EAS4 
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Microtext 
Acornsoft 
£57.00 cassette 


Microtext is one of Acornsoft’s more 
intriguing products. It is described by the 
company as an authoring language, but 
this means very little to most people. 

Essentially Microtext helps anyone 
teaching with aids and computer-like 
facilities, without requiring that the 
teachers have any special computing 
skills. Typical applications are job training 
courses, basic school teaching and first 
level job interviews — although it may come 
across as rather impersonal on the latter. 

The package was designed by the 
National Physical Laboratory and 
implemented on the BBC Micro by Ariadne 
Software. It comes in a standard Acornsoft 
languages box containing the cassette, a 
welcome-guide, a reference card, key 
underlay and a full User Guide. Disc and 
ROM versions are promised for the future. 

The first really noticeable thing about 
Microtext is its friendliness. At all times 
during command mode typing HELP gives 
just that. A page of text explaining each of 
the major commands in reasonable detail. 
Considering the provision of both a User 
Guide and the extremely useful laminated 
quick reference card, a user would find it 
very difficult to get confused. 

At this stage one is naturally tempted to 
run the suite of example programs 
provided under the general banner of 
WELCOME - they are well worth it for intro- 
ductory purposes, although each has a 
fairly trivial function. 

Once these have been run a thorough 
read of the manual is essential and fairly 
lively; the two editors have combined a 
knowledge of the product with an under- 
standing of others’ misunderstandings. 
Far better than the BBC Micro User Guide 
itself in fact. 

A Microtext program is structured some- 
what differently to a conventional program, 
consisting of frames rather than individual 
lines. Each frame can have a combination 
of displayed and non-displayed com- 
mands. For instance, one may choose to 
get an input from the subject, and it is fairly 
likely that a prompt would be issued to 
guide the subject. in most instances a pro- 
gram would be written in and ultimately use 
the BBC's Mode 7 (Teletext) display, as 
this is the most visually appealing and 
easiest to manipulate. However most other 
screen modes are supported and more 
complicated graphics such as charts could 

then be drawn. In non-teletext modes the 
| red function keys produce foreign charac- 
ters and mathematical symbols. 

Considering that the BBC Micro was 
originally intended for serious educational 
purposes, Microtext is a very welcome 
addition to the Acornsoft catalogue — but 
why two years after the release of the micro 
itself? Another case of Acorn's prevarica- 
tion, joining the second processors, 
| Prestel adaptors and so on. And Microtext 
‘| does not as yet work properly with the 
'| 6502 second processor. AD 
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SOFTWARE 
FILE 


A BUYER'S GUIDE TO UTILITY SOFTWARE 
- Software file is a monthly rundown on the utility 
packages available for the BBC, Spectrum, ZX81, 
Dragon, Oric, CBM 64 and VIC 20 computers. This 
month the microscope is on the programming 
languages available in home computing, and on 
extensions available to standard BASICs supplied with 
the machine. 


LANGUAGES - BASIC 
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EXCITING ADDITIONS FOR 
YOUR HOME COMPUTER 


KEYBOARD with 
ELECTRONICS 
for ZX SPECTRUM 


* Full size, full travel keyboard that 
simply plugs into expansion port on 
your Spectrum. * Offers single key 
selection of all major multi-key 
functions. * Extends port for other 
peripherals. * Can accept Atari-type 
joysticks (optional extra — order 2 of 
FG66W, £1.36 each and note that 
case will require cutting). 

Three kits needed to build unit: 
Order LK29G, LK30H & XG35Q. 
Total price £39.95. Full construction 
details in Project Book 9 XA09K 70p. 
Also available ready-built. Order As 
XG36P. Price £44,95. 


KEYBOARD with 


ELECTRONICS for ZX81 


* Full size, full travel keyboard that’s 
easy to add to your 2X81. * No sold- 
ering in ZX81; simple instructions 
make it easy to fit. * Makes Shift 
Lock, Function & Graphics 2 single 
key selections. 

Complete kit (excl. case) LW72P 
Price £23.95. Case XG17T £4.95. Full 
construction details in Project Book 
3 XA03D. Price 70p. Ready-built in 
case XG22Y. Price £32.50. 


A CCITT standard modem that conn- 
ects directly to your telephone line 
via a BT approved transformer. 
Transmits and receives simultan- 
eously on European standard fre- 
quencies at 300 baud, May be used 
to talk to any other 300 baud Euro- 
pean standard modem including the 
Maplin Computer Shopping modem 
on 0702 552941 and any British 
Telecom Datel 200/300 Service mod- 
em. The modem’s computer inter- 
face is RS232 compatible. 

Complete kit (excl. case) LW99H. 
Price £44.95. Case YK62S £9.95. Full 
construction details in Project Book 
5 XAO5F Price 70p. 


NIAPLN 


ELECTRONIC SUPPLIES LTD 


INTERFACES for MODEM 


Interfaces are now available forthe | 
following machines: Commodore 
64, Dragon 32, Oric, Spectrum, 
VIC20 and ZX81. Each is complete 
with a Machine Code Communicat- 
ions program. The BBC micro needs 
no interface and a suitable program 
is on Maplin catalogue page 15 or 
Project Book 8, page 59. 

Computer Order Details Price 
64/VIC20 LK11IMBook7 £9.45 
Dragon32 LK12N Book8 £18.95 
Oric 1 LK40T Book 10 £13.95 
Spectrum LK21X Book8 £19.95 
2X81 LKO8J Book7 £29.95 


Project Book 7 XAO7H. Price 70p. 
Project Book 8 XA08J. Price 70p. 
Project Book 10. XA10L. Price 70p. 


ZX81 1/0 PORT 


* Provides two bi-directional ports 
for 16 input or output lines. * One 
buffered output which can interface 
directly to CMOS. * On board 
address selection permits expansion 
to six ports with two boards. 
Complete kit LW76H. Price £10.49. 
Full construction details in Project 
Book 4 XA04E. Price 70p. 


MAPLIN CATALOGUE 


Full details of all Maplin’s projects 
and electronic components in our 
huge 480 page catalogue. On sale 
now in all branches of W.H. Smith 
price £1.35. Or send £1.65 (incl. p&p) 
to our mail order address. 


OTHER PROJECTS 


For full details of our other computer- 


related projects please see the 
relevant project book as below: 
BBC Motherboard — Book 11. 
ZX81 Sound on TV — Book 6. 
2X81 Extendi-RAM — Book 9. 
VIC20 Extendiboard — Book 9. 
Dragon 32 Extendiport — Book 10. 
TTL/RS232 Interface — Book 9. 
Project Book 6 XA06G. Price 70p. 
Project Book 9 XAOSK. Price 70p. 
Project Book 10 XA10L. Price 70p. 


Project Book 11 XA11M. Price 70p. 


SPEECH SYNTHESISERS 


* Unlimited vocabulary with allo- 
phone (extended phoneme) system. 
* Can be used with unexpanded 
Oric 1, VIC20 or ZX81 as it does not 
require large areas of memory, 

* Speech may be easily added to 
programs. *In VIC20 version speech 
output is direct to TV speaker with 
no additional amplification needed. 
Computer Order Details Price 
Oric 1 LK28F Book9 £23.95 
VIC20 LKOOA Book6 £22.95 
2X81 LKO1B Book6 £19.95 
Project Book 6 XA06G. Price 70p. 
Project Book 9 XAOSK. Price 70p. 


DRAGON 32 I/O PORT 


* Provides two TTL & 3-state bus 
compatible 8-bit ports, * Four norm/ 
inv. latched ports, * Two relay 
switched ports * And two opto 
switched ports. * Module plugs 
directly into cartridge socket and is 
fully programmable from BASIC. 
Complete kit LK18U. Price £14.95. 
Full construction details in Project 
Book 8 XA08J. Price 70p. 


SPECTRUM EASYLOAD 


* Greatly reduces cassette LOADing 
& SAVEing problems on Spectrum. 
* Battery powered, no bus connect- 
ions. * Charging from Spectrum 
PSU. * SAVE & LOAD indicators. 
Complete kit (excl case) LK39N. 
Price £9.95. Full construction details 
in Project Book 10 XA10L. Price 70p. 


ZXS1 HI-RES GRAPHICS 
* Full 256 x 192 fine pixel display 
with normal or inverted video. 

* Draws lines, circles and triangles, 
fills and textures, * Up to 32 user 
defined graphics. * Operates direct- 
ly from extended BASIC. 

Complete kit LK23A. Price £27.50. 
Full construction details in Project 
Book 9 XAO9K. Price 70p. 


ZX81 SOUNDS 
GENERATOR 


* Turns your 2X81 into a mini- 
synthesiser. * 3 programmable tone 
generators. * 3 programmable att- 
enuators. * Noise generator with 3 
pitch levels for special effect sounds. 
* Single address access with PEEK 
& POKE. * Connects directly to 
extension board or expansion port 
socket with extra socket (order 
RK350 £2.20) * Requires separate 
amp and speaker. 

Complete kit LW96E, Price £13.49. 
Full construction details in Project 
Book 5 XAO5F. Price 70p. 


*Plugs directly into 2X81 expansion 
port. * Accepts a 16K RAM pack and 
three other plug-in modules simul- 
taneously. Parts are sold separately 
as follows: 

PCB GBO8J. Price £2.40, Edge Conn- 
ectors (4 needed) RK35Q. Price £2.20 
each. Track pins (1 pack needed) 
FL82D. Price 85p per pack of 50. 
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